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Iliac program youVe writing couldhave trouble executing 
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To Order VMData 
or to receive a free report 
entitled 

“Data Management 
Solutions for Windows C 
and C++ Programmers” 

Call toll-free 

(800) 826-8086 

or fax your request to 

(713) 460-2651 


Here's the problem: _ 

Windows doesn’t offer virtual memory for data in all modes. With 
the 8192 system-wide GlobalAlloc limit and the inability of Windows 
to swap data to disk in some modes, programs using as little as 100K 
of dynamic data may fail to execute properly in some Windows 
environments. 


J 1i J 7 VMData is the solution. Designed to be used for 
high-performance, commercial-quality applications, VMData is a 
Windows DLL that manages up to 128 megabytes of data. VMData’s 
advanced virtual memory scheme adheres to Windows rules and 
recommendations, and uses all memory types available in all 
Windows modes. This ensures that your application is a “good 
citizen” under Windows 
and will not impede the 
overall performance of 
the end-user’s machine. 


POCKET 


VMData supports Microsoft®C 
and C++ (5.1,6.0,7.0), Borland®C++ 
(2.0,3.0,3.1) across multiple platforms. 


No Limits 


PO Box 821049 Houston, TK 77282 Phone (713) 460-5600 Fax (713) 460-2651 

“Pocket Soft” and ‘VMData’’ are trademarks of Pocket Soft, Inc. All other trademarks are property of respective owners. 
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C CODE FOR THE PC 

source code, of course 

Embedded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootable installations).$375 

Style (a C+ + class libraty to build, maintain and traveise arbitraiy, non-taxonomic links between C++ objects).$300 

Spell Time (spelling checker for incorporation into text products; no royalty; large dictionary; small and fast).$300 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

INGRAF (graphics for scientists & engineers, all sorts of graphs & plots; specify Microsoft or Borland).$275 

The Snooper (Ethernet protocol analyser for Novell Netlfere and LAN Manager Networks; capture packets; real-time display).$275 

TirboTtept (Release 3.0; HP, PS, dot drivers; CM fonts; LaTJ^C; MetaFbnt).$250 


Updated! C Communications Tbolkit by Magna Carta (Version 2.0; multi-port & co-processor support, FAX, interrupt driven, emulations, xfer protocols) $210 

PxSQL (SQL for Borland's Paradox Engine; ANSI X3.135-1989 SQLDML standard; network server not required).$180 

c.pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support).$170 

C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, disk pager, database functions, much more).$170 

Viewpoint (C++graphics library; 32-bit color, pattern fill, scroll & bitmap, coordinate tranformations).$170 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25" or 3.5” diskettes).$150 

ViewTMeve (relational view of Novell Btrieve databases; includes EZTMeve).$150 

Ddorie GCC for MS-DOS (Version 2.2.2; includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

Updated! Ibrow (Version 4.0; programmer’s Windows-based editor, large files, help, undo/redo, drag-n-drop, function & type tags).$115 

Dr. MD (runtime memory analyzer & debugger; find many memory corruption errors; examine memory usage).$110 

Updated! 386BSD Version 0.1 & LINUX Version 0.96(two Unix clones for Intel 386).$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Demacs (complete GNU Emacs for DOS; needs djgcc to build; based on 18.55).$100 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

NETS Version 3.0 (neural net simulator from COSMIC) .$85 

Ibrow (programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$115 

HorC++ Power (C++ Class Libraty for Borland’s Paradox Engine).$80 

ET Neural Net (hack error propagation; specify DOS or Windows).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C-)—h).$65 

LDB (Loose Data Binder; persistent data objects for C++; handles pointers between objects) .$60 

ICier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS (Purdue Compiler Construction Tool Set; ported to Microsoft Q like YACC and LEX together with lots of additional features) . . . $60 
MEM.WING (global memory manager for Windows, supports standard C memory allocation calls to "wing” your old C code into Windows) . $55 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

NEW! Moby Crypto (encryption/decryption routines; Vol.l: DES, Lucifer, SRNG, ARNG; Vol. 2: PGP, RSA, MD4, ShA; both vols. $75) . . . each $50 

OBJASM (convert .obi files to .asm files; output is MASM compatible) .$50 

CLIPS Version 5.1 (rule-based expert system generator; advanced manuals available at additional cost).$50 

NIH Class Library k Book (basic C++ classes & Data Abstraction and Object-Oriented Programming in C+ + in softback by Keith Gorlen) . $50 

Editor Pack (20 public domain editors; microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

MiaoC C Compiler (relargetable C compiler/optimizer, lots of docs, very portable, 8066 tables included; tables for 7 extra epu’s $50) .... $50 

NE W! PICTOR (Video library; multi-pane windows, menus, hypertext help, serial communications; text editor example; much more).$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) .... $40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) . $35 

RXC k EGREP Version Z0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Database Pack (9 databases - simple to complex: isam, bplus, AVL SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars).$35 

NEW! PASSWORD (password-protect a running PC while you’re away from your desk; includes intrusion log) .$30 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

Alloc-GC (a garbage-collecting memory allocation library).$30 

REGX Plus (Version Z0, search and replace string manipulation routines based on regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

UUPC Pack (TJUCP for the PC; UUPC Version 1.11V, smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX (fast lexical analyzer generator; new, improved LEX; BSD Version Z3.6 with docs).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

PCAL Personal Calendar (generates PostScript calendar for any month or year, lots of options, personalization file for your dates & schedule) $20 

Publisher’s Interchange Language (PILTbol Kit, Version 5.0, API Z0 by Quark).$20 

NetCDF (Network Common Data Form; general-purpose data exchange for scientific data; many tools and programs available).$20 

NEW! Simple Socket Library (Unix, VMS and MS-DOS; sits on TCP/IP stack).$20 

Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moby Shakespeare (plays, sonnets, etc. ... every last word).$60 

Dictionary Wbrd List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world countiy boundaries).$30 

Lots 'O Words (160,066 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

Tixt Pack (1990 ClA World Fact Book, Hacker’s Jargon File, Acronyms, Koran, Mormon Scriptures, One Liners, Mnemonics, more) .... $25 

CD-ROMs 

FontMaster Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB).$70 

Updated! InfoMagic (X11R5, Thhoe 4.3, complete GNU, ISODE, KA9Q k NCSA TCP/IP, Demacs, Djgcc, 386bsd, some GNU on Windows NT) . . . $70 

Prime Time Freeware (over 1 gigabyte of Unix Coode).$60 

Wrlnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Whlnut Creek Usenet and Simtel Unix-C (600MB).$35 

Whlnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 


11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 


Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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Save Time And Money 

Add Sophistication anti Flexibility to 
Your Windows Application 



Professional 
Toolbox For Mom 

With 23 custom controls - including the 
industry's only full-featured Spreadsheet 
control - and more than 300 functions, 
Professional ToolBox is the most complete, 
flexible and powerful Windows development 
package on the market. 

The Spreadsheet control of ToolBox is 
unparalleled by any other package in its 
features, flexibility and power. 

New features include: 

• Full sorting support 

• Addition of a checkbox celltype and owner 
draw celltype 

• Place borders around a cell, row, column, 
or range of cells 

• Virtualized database support 

• Selection of multiple blocks 

• Overflow text to next column 

• Single-select, multi-select feature 

• Place multi-line edit within a cell 

• Change color of grid 

• Drag and drop 

• Plus, full clipboard support 

Other custom controls are Formatted Edit 
Controls, Tool Bar and Status Bar, 3D 
effects, View Pictures with animation, and 
Enhanced Listbox. Functions include DOS 
System functions, Date/Time support, String 
functions, and Enhanced File support. 

Professional ToolBox supports MSC 7.0, 
Borland C++, Borland C++ Owl, Turbo 
Pascal, Actor, WindowsMaker Pro, Borland 
Resource Workshop, GFA, Microsoft C++ 
and Dialog Editor. 

Price $345 (no royalties) 


TM 


For Visual Basic 

Visual Architect™ is a product that 
no Visual Basic developer should 
do without. Designed to accelerate 
your development schedule, Visual 
Architect™ can handle any 
application you're developing. 


The "true" Spreadsheet control, makes 
Visual Architect™ stand out from any other 
software package. A major design goal was 
to make the spreadsheet extremely flexible 
and powerful. It can be used within your 
application as a functional spreadsheet - as 
a simple way of obtaining variable lines of 
data from the user - or as an easy way of 
displaying tables of information from a 
database. 

Because of its extreme flexibility, the 
spreadsheet can be customized for each 
individual user. It can be optionally locked 
so the user can't make changes. The width 
and height of columns and rows may be 
changed. The font, color, and data type may 
be changed for any row, column or cell. 

Cells can have the following data types: 
edit, date, time, integer, float, static, 
formatted pic, combobox, button, and 
picture. Formulas can be added to any cell. 
Full-print support is built-in. 

Other features of Visual Architect™ include 
the Formatted PIC, Integer, Floating Point, 
Date with Calendar, Time and View Text. 

The Visual Architect™ manual is 
professionally written and 
contains extensive documentation. 

Visual Architect™ 

Winner of Reader’s Choice Award 1992 

Only $245 (no royalties) 



Development Tools Backed by Professionals 

"FarPoint's Visual Architect™ spreadsheet is a 
proven and robust tool that can easily meet the 
changes of mission critical teal world applications. 
FarPoint's design and documentation made it easy 
to master and embed the spreadsheet in our systems. 
Being Vertical Application Integrators, we demand 
versatility from all of our tools, and FarPoint's 
Visual Architect™ exceeded our expectations." 

GregMeinick 

Vice President Thple-I Software 

Triple-I has been providing consulting and technical service solutions to 
Fortune 500 companies for 21 years. 


FarPoint Technologies offers a SO day, no-hassle, money-back guarantee. 

To order or receive additional information call: 

FarPoint Technologies, Inc. 1-800-645-5913 or 1-614-763-4333 

Agency: MF Schwab & Associates, Inc., Dublin, OH — ^ Up 
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From 

the Editor 


A random sample of subscribers at the Windows and OS/2 show in San Jose 
shows that a good many of you still don’t know you can grab our code listings and 
online index off of CompuServe. Just go to the CLMFORUM forum and look around 
library 7. You can find the code listings for the most recent months and windex.zip, 
a Windows help file that cross-references all the articles in all our 1992 issues. Look 
in the table of contents under “Source Code Availability” for other locations you can 
obtain our code listings. 

January was a great month for problems. The central system at R&D lost a hard 
disk, leaving the technical support team scrambling to get everything back online. If 
you sent us mail towards the end of January and didn't get a reply, please send it 
again. 

Last month’s table of contents said “Next Month ... Turbo Vision Traps and Techni¬ 
ques." Unfortunately, that article will appear next month. While I’m replacing broken 
promises, why not go all the way out on a limb? Next month is our Windows NT 
theme and we will have a great article on NT security and John Richardson will 
show some innovative techniques for working around the current limitations of NT's 
P0SIX subsystem. 

Paul Bonneau’s prospective column looks quite interesting as well. A reader asks 
for an edit control that handles font changes, which is really a large project, not 
something you could supply in the space of a magazine column. However, Paul 
delivers the goods in only a few hundred lines of code with a little peeking, poking, 
and general nastiness. Will it be too outrageous a hack for even us to print? Tune in 
next month and find out. 

To cap off the month, I (unintentionally) wrote my first self-destructing program. 
It is a “cc" command that provides a vendor-independent interface to compiling DOS 
and Windows programs. As I developed it, I tested each new change by using it to 
compile itself. The last change was to have it generate a module definition file if 
none was supplied for a Windows program. Naturally, I tested it by typing “cc cc.c’’ 
to compile itself and it should have generated a “ccdef" file. Unfortunately, the logic 
to set the file extension was wrong and it promptly wrote a module definition on 
top of “cc.c," its own source. What’s the largest amount of data you’ve ever 
destroyed in a single sitting? Mail me your best horror story so I have something 
humorous to read while I retype my program. 


Ron Burk 

Editor 

CIS: 70302,2566 ; BIX: rlburk-, Internet: ronb@rdpub.com ("... !uunet!rdpub!ronb") 
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Flying Blind? 



Imagine you're flying a plane with the 
dashboard of the cockpit covered up. No 
speedometer, no altimeter, no compass, no 
temperature gauge. 

Is your program flying like that plane? 
Could a pilot stop the plane every ten yards, take a 
peek at the dashboard and then cover it up again? 
Why should you make do with just a 
source code debugger? 

If only your program could have a dashboard. A 
graphic display running side-by side with your 
own windows. If only you could pick any 
variable from your code. 

+ Display its value or show it as a dial. 

+ Plot its changes over time in a graph. 

+ Display statistics on it, such as rate of 
growth, max, etc. 

The display would be updated instantly, in real 
time without your program having to stop, or even 
slow down. Exactly the way a dashboard works. 

Please, have a seat. In your own 
program's cockpit. 

TrackDeck™ is the dashboard, 


How it works: TrackDeck has two parts: 
The Tracker DLL and the Dashboard window, 
You insert a one-line command in your code 
for each variable you want to watch. The 
Tracker monitors the value and informs the 
dashboard window whenever it changes. 


A NEW METHOD OF 
DEBUGGING 

You spend a lot of your valuable time 
searching for bugs. 

This is because the classic symbolic debuggers 
only find bugs fast in some situations. Real-time 
debugging and graphs are the tools every 
professional programmer needs. 
TrackDeck takes minutes to start using and costs 
less than the time spent finding one bug. 
Add it to your tool-box. 

Explore the world beyond debugging... 
focus visually on performance, quality 
and algorithm efficiency. 

This isn't a tool for only some applications. It 
isn't a tool for only some programmers. It is one 
of those rare instances of a breakthrough that is 
relevant to every programming task. 

Available now for Windows C/C++, 
Visual Basic, TPW and Object 
Vision programmers 

TrackDeck is now selling at $129. For 
discounts, call: The Programmers Connection: 
800-336-1166 

Dashboard Software 

4 Louis Ave, Monsey, NY 10952 

s ( 914 ) 352-8071 
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Real-World Device Control 


John Reynolds 



Real-world data acquisition systems require precise timing of control components 
and read sequences. While you can use more exotic add-on hardware, the standard 
PC-AT provides the basic facilities needed in a data acquisition environment. Critical 
high-speed timing pulses are available via the real-time clock, and direct digital input 
and output signals are available at the standard parallel printer port. The stepper 
motor controlled system presented in this article demonstrates the software and 
hardware interfaces necessary to harness the power of the PC for data acquisition. 

Real-Time Clock Interrupt 

AT-compatible PCs are equipped with an onboard real-time clock. Functions of 
this clock include time and date tracking, generation of a scheduled alarm interrupt, 
and the generation of a periodic interrupt you can program to activate 128, 1024, or 
4096 times per second [1]. By hooking into this periodic interrupt, you can obtain a 
timing base that far surpasses the precision of the standard 18.2 ticks per second 
timer interrupt commonly used in PC timing applications. 

rtclock.c (Listing 1) presents the routines used to access the real-time clock 
periodic interrupt. The periodic interrupt, which is handled through interrupt vector 
70h, is activated by calling EnableRtcIntsf), and deactivated by calling DisableRtc- 
Ints(). EnableRtcInts() installs the new interrupt handler RtcHook() and activates 
the interrupt. RtcHook() takes care of the administrative details of the interrupt 
handler, and makes a call to the user-defined function pointed to by NewRtcVec. 
NewRtcVec is declared in rtclock.h (Listing 2), and must be set prior to activating 
the periodic interrupt Since it is linked into an interrupt handler, the function that 
NewRtcVec points to should be kept as small and as fast as possible. 


John Reynolds serves the Lord Jesus Christ as a senior electrical engineer at Magnetic 
Technologies Corporation, a company specializing in the design and manufacture of 
components and subassemblies for the copy and printer industries. He develops and 
maintains programs in Pascal and C, mostly in the areas of data acquisition and 
statistical analysis. John has a bachelor’s degree in electrical engineering technology 
from Rochester Institute of Technology. You may contact John at Magnetic Tech¬ 
nologies Corporation, 770 Linden Ave., Rochester, NY 14625. 
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Real-Time Programming 


Using PC Hardware 


The frequency of the periodic interrupt is specified by the 
EnableRtcIntsf) function parameter ClockSpeed. Constants 
for the allowable values of ClockSpeed are defined in 
rtclock.h as Hzl28, Hzl024, and Hz4096. 

A special note should be made regarding the operation of 
the periodic interrupt at 4096 Hertz. The code lets you run the 
interrupt at this high speed in order to showcase all of the 
capabilities of the clock source, but in practice, you must take 
extreme care to keep the interrupt handling routine as fast as 
possible. I had many machine lockups while debugging the 
code for this article as a result of inadequate code execution 
speed while running the interrupt at 4096 Hertz! 

The global variable RtcCounter records the total number of 
periodic interrupts that occur while the interrupt is active. 
Finally, DisableRtcInts() causes an immediate termination of 
periodic interrupts and restores the original interrupt vector. I 
am grateful for permission to use adapted versions of code 
originally published by Kenneth Roach in Dr. Dobb's Journal [2]. 
His article, "Using the Real-Time Clock,” provides in-depth real¬ 
time clock implementation details, and serves as an excellent 
reference. 

demortc.c (Listing 3) presents a simple demonstration pro¬ 
gram to exercise the real-time clock routines. It acts as a 
count-up timer, displaying the time in seconds and the num¬ 
ber of real-time clock interrupts generated at the user- 
specified interrupt frequency. 

Printer Port Digital I/O 

The electrical interface between the PC and printer is com¬ 
posed of a number of TTL level digital input and output lines. 
printdio.h (Listing 4) details the pinout of these lines in the 
parallel port connector. The PC uses the eight digital output 
lines to send data to the printer one byte at a time, and the 
digital output routines in printdio.c (Listing 5) use these 
same lines. The routines in printdio.c let you set or clear all 


bits at once, set or clear an individual bit, configure the bits to 
a specified bit pattern, and set or clear selected bits based on 
a specified bit mask. A bit that is “set” presents a +5 volt 
signal at the port connector, and a bit that is “clear” presents 
a 0 volt signal. Two additional functions let you read the cur¬ 
rent status of the output bits individually or as a byte value. 

The bits used for digital input are obtained through uncon¬ 
ventional use of the printer's status and control lines. 
printdio.h identifies the port connector pins used for digital 
input, the printer’s use of the signals on these pins, and the 
bit assignments that are made for use as generic digital input 
lines. The digital input functions in printdio.c take care of 
correctly interpreting the active low signals so that all inputs 
at +5 volts are considered "set” and all are considered "clear.” 
printdio.c provides functions for reading any bit individually 
and for reading all bits at once as a byte value. 

Although the signals provided at the parallel port connec¬ 
tor are capable of driving TTL loads, it is best to buffer the 
inputs and outputs with a circuit such as shown in Figure 1. 
This protects the parallel port hardware from shorts in exter¬ 
nal circuitry and from incorrectly applied input signals. Uncon¬ 
nected TTL inputs usually assume a high level, but it is best to 
tie unused input lines high or low to provide a known state. 

PC software communicates with external printer devices 
via three I/O ports, located at I/O addresses 03BCh, 0378h, and 
0278h [3]. Any individual PC may or may not have a device 
connected to any of these ports. DOS assigns a logical device 
name to each port that does have an associated hardware 
device. DOS names the first active port “LPT1”, the second 
"LPT2”, and the third "LPT3”. At boot time, the BIOS records the 
I/O address of the hardware port assigned to LPT1 in location 
0000:0408h, the address of the port for LPT2 in 0000:040Ah, 
and the address of the port for LPT3 in 0000:040Ch [4], The 
BIOS memory locations for unused LPT ports are assigned a 
value of zero. 
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1 ime is money. 


The advantages of OS/2® are clear. “At Life Care 
Development Corp., we create applications for sale 
to physicians, psychiatrists and drug counselors for 
tracking patient and insurance information, and 
medicine and treatment goals. We make use of 
OS/2 s inherent development capabilities like the 
REXX language as well as WorkFrame/2 (IBM’s 
development environment), C Set/2 compiler and 
Borland ObjectVision? For us, OS/2 has meant 
heightened productivity, shortened development 
time and improved quality of product.” 

Work in a customizable object-oriented 
environment without constraints. Enjoy true pre¬ 
emptive multitasking, unlike what 
you get with Windows™ and other 
DOS extenders. “With OS/2,1 can 
reliably run several development 
applications at the same time: 



QbjectVision 



edit in one window, compile in 
another, link in a third and test 
in a fourth. I’m amazed how quickly 
I can compile a program while print¬ 
ing a copy of the source code.” OS/2 
gives you the capability to have mul¬ 
tiple configurable sessions in which 
to build and test your applications. 



“OS/2 is easier to get into.” 

OS/2 Crash Protection™ helps you lose your 
fear of crashing and rebooting. If one app goes 
down due to a bug, the rest you’re working on 
won’t. OS/2 isolates the failure, 

7 19 9 2 

letting you fix it and restart it with- 

. PC a. * ,i r'v • for Technical Excellence 

out attecting other apps. Dynamic 
Link Libraries allow applications 
to share common functions, 
making them smaller and easier 
to maintain. 

“I’ll never go back.” 

“I may be a small ISV, but IBM has always 
treated me like a big fish.” IBM’s valuable technical 
service and marketing support includes OS/2 Sup¬ 
port Line, IBMLink, the IBM OS/2 bulletin board 
system and several OS/2 developer forums on 




In the Workplace Shell™you can edit source codefiles while 
compiling and debugging in the background. 







































The no-comparison comparison chart. 



Windows 3.1 

OS/2 

Virtual memory limit 

4 x physical 

512MB (disk space) 

Memory model 

Segmented 

(64KB) 

Flat memory objects 

APIs 

16 bit 

Full 32 bit 

Multitasking—DOS apps 

Time slicing 

Pre-emptive time slicing 

Multitasking—Windows/PM apps 

Cooperative 

Pre-emptive 

Priority 

Static (set by user) 

Dynamic 

Dispatchability 

Process 

Thread 

System services 

Serial 

Parallel 

Protection between apps 

Unprotected 

Protected 

Kernal protection— 

DOS/Win/PM apps 

Unprotected 

Protected 

File system 

FAT 

Enhanced FAT and 
installable file systems 
(HPFS, CD-ROM) 

User interface 

Windowed 

Object oriented 


IBM and OS/2 are registered trademarks and Workplace Shell and OS/2 Crash Protection 
are trademarks of International Business Machines Corporation. All other products are 
trademarks or registered trademarks of their respective companies. ©1993 IBM Corp. 



CompuServe? “If I run into a problem, the OS/2 
Developer Assistance Program is there to help. ’ 
The 32-bit operating system lets you break 
through the 64K code segment barrier and convert 
to a Hat memory model with up to 512MB of mem¬ 
ory per session for writing code. “Writing is easier 
and faster than ever—and bugs have never been 
easier to uncover and zap.” 


a 


nn 


I’m actually having fun again. 

But the best reason for leaving Windows 
and other DOS extenders is the opportunity to 
develop truly revolutionary OS/2 applications. You 
could say OS/2 has closed the door on Windows. 
For the free white paper on why OS/2 is the 
developer s platform 
of choice, or for more 
information, call 

1 407 982 - 6408 . ===== 7 = 

























The initialization function use_port_LPT(), in printdio.c, 
checks the BIOS memory to be sure that the requested LPT 
port is available, returning either the hardware port address 
associated with the LPT number or zero if the port is not 
available. This function must be called successfully before any 


other digital input or output function, otherwise all other calls 
will be ignored. 

demodio.c (Listing 6) presents a demonstration program for 
exercising the facilities provided by the printdio engine. 


Listing 1 rtclock.c — Real-time clock (RTC) interface routines 


/* 

Title: 

RTCLOCK.C 

* 

Idefine 

IMR2 

OxAl 

* 

Author: 

John Reynolds 

* 

Idefine 

CMD1 

0x20 

★ 

Purpose: 

Routines to tap the Real Time Clock 

* 

Idefine 

CMD2 

OxAO 

* 


periodic interrupt which can be set 

* 

Idefine 

E0I 

0x20 

★ 


to run at 128, 1024, or 4096 Hertz 

★ 

Idefine 

RTC MASK 

OxFE 

★ 

Note: 

EnableRtcIntsO. DisableRtcIntsO, and 

* 

Idefine 

STATUSB 

OxOB 

★ 


RtcHookO were originally coded in 

* 

Idefine 

STATUSC 

OxOC 

★ 


Pascal and were Copyright 1990 by 

* 

Idefine 

RTC FLAG 

0x40 


Kenneth Roach and published in 
Dr. Dobb's Journal, June 1991, page 88. 
Modified by John Reynolds to allow 
selection of three clock frequencies 
(128 Hz, 1024 Hz, and 4096 Hz). 
Copyright 1991 Magnetic Technologies Corporation 
Rochester, New York 14625 


int RtcCounter; /* total number of Rtc ISR calls */ 
unsigned char OldMaskA, OldMaskB; 

void interrupt (*01dRtcVec)(void); 
void (‘NewRtcVec)(void); 


finclude <dos.h> 
#include "rtclock.h" 


void interrupt RtcHook(void) 

{ 


Idefine 

CMOSFLAG 

0x70 

Idefine 

CMOSDATA 

0x71 

Idefine 

STATUSA 

OxOA 

Idefine 

RTC VEC 

0x70 





: V SOURCE VSSASSD 


mO'Unfe'Z* 

ontroy|yst< 


Manage Reusable 
Code: Files Shared b', 
Many Project 

Support Cross-platform 
Development for DOS, 
Windows, WlnNT... 
even the Mac! 

Generate Complete 
File and Project 
Histories 

Coordinate Your Entire 
Team 

Start Coding In 
Minutes, not Days! 


SourceSafe 


^ One Tree Software 

PO Box 11639 Raleigh, NC 27604 
800/397-2323 fax: 919/821-5222 voice: 919/821-2300 


disableO; /* asm cli */ 

outportb(CMOSFLAG.STATUSC); /* Is this interrupt */ 
if (inportb(CMOSDATA) & 0x40) /* for us? */ 

( 

NewRtcVec(); 

/* signal end of interrupt to 8259s */ 
outportb(CMDl, E0I); /* primary 8259 */ 

outportb(CMD2, E0I); /* secondary 8259 */ 

) /* if interrupt for us */ 
else 01dRtcVec(); 
enableO; /* asm sti */ 

) /* interrupt Rtc_hook() */ 

/*.*/ 

void EnableRtcInts(int Clockspeed) 

( 

/* change interrupt vector */ 

OldRtcVec = getvect(RTC_VEC); 
setvect(RTC_VEC, RtcHook); 

/* enable clock interrupt */ 
outportb(IMR2, inportb(IMR2) & RTC_MASK); 
outportb(CMOSFLAG, STATUSA); 

/* select clock frequency */ 

OldMaskA = inportb(CMOSDATA); 
outportb(CMOSFLAG, STATUSA); 

outportb(CMOSDATA, OldMaskA & (Clockspeed | OxfO)); 
/* enable periodic interrupts */ 
outportb(CMOSFLAG, STATUSB); 

OldMaskB = inportb(CMOSDATA); 

outportb(CMOSFLAG, STATUSB); 

outportb(CMOSDATA, OldMaskB | RTC_FLAG); 

) /* EnableRtcIntsO */ 

/*.*/ 

void DisableRtcInts(void) 

{ 

outportb(CMOSFLAG, STATUSB); 
outportb(CMOSDATA, OldMaskB); 
outportb(CMOSFLAG, STATUSA); 
outportb(CMOSDATA, OldMaskA); 
outportb(IMR2, inportb(IMR2) & !RTC_MA$K); 
setvect(RTC_VEC, OldRtcVec); 

} /* DisableRtcInts() */ 

/* End of File */ 
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Listing 2 rtclock.h — Real-time clock (RTC) interface header file 


/* Title: RTCLOCK.H 

* Author: John Reynolds 

* Purpose: Routines to tap the Real Time Clock 

* periodic interrupt which can be set 

* to run at 128, 1024, or 4096 Hertz 

* Copyright 1991 Magnetic Technologies Corporation 

* Rochester, New York 14625 

#ifndef RTCLOCK H 
#define RTCL0CK~H 


Idefine Hzl28 2 /* Allowable values for */ 

Idefine Hzl024 6 /* periodic interrupt */ 

Idefine Hz4096 4 /* Clockspeed. */ 

void EnableRtcInts(int Clockspeed); 
void DisableRtcInts(void); 

extern int RtcCounter; 
extern void (*NewRtcVec)(void); 

lendif 

/* End of File */ 


Stepper Motor Data 
Acquisition System 

The remainder of this article 
demonstrates PC device control 
capabilities as applied in a basic data 
acquisition system. The system records 
data from analog and digital sensors at 
equally spaced angular positions 
thoughout the rotation of a stepper 
motor. The real-time clock and printer 
port I/O routines presented earlier are 
used to accurately control stepper 
motor rotation and synchronize the 
series of analog and digital reads that 
must occur throughout the rotation. Fig¬ 
ure 2 shows the hardware connections 
used to implement this system. 

Stepper Motor Control 
and Terminology 

Before examining the data acquisi¬ 
tion system in detail, a basic review of 
stepper motor control is in order. The 
stepper motor shaft rotates one angular 
increment, or step, at a time. The num¬ 
ber of steps that constitute one com¬ 
plete rotation of the motor shaft 
depends on the construction of the 
motor and the stepping method 
employed by the controller electronics. 

The real-world interface of the step¬ 
per motor controller is called a trans¬ 
lator, and it provides two digital input 
lines labeled STEP and DIRECTION. Each 
time you apply a pulse to the STEP 
input, the motor shaft moves one step 
in the direction specified by the state of 
the signal present at the DIRECTION 
input. When the DIRECTION input is 
high, each step moves clockwise, other¬ 
wise it moves counterclockwise. 

You can describe the rotational 
movement of a stepper motor with a 
velocity profile. As pictured in Figure 3, 



THE MODEL 

From a seven line ’Hello World!’ program (the smallest in 
the industry) to the most complex server/client 
architecture, Diamond Toolkit’s consistent model 
will save you time ^and mo ney^ ^ ^ ^ 

The simplicity and power of Diamond Toolkit comes from 
its callback functions attached to objects (even objects 
created with dialog box editors), menus, windows, and tasks. 
This simple mechanism not only reduces the size of your 
code by at least a factor of ten, but makes your software easy 
to understand and maintain. 

SMART OBJECTS 

Once created, objects can be moved, resized, modified, 
enabled, disabled, removed, and their relative position 
(front, back) changed. Objects react to mouse clicks and 
dragging by invoking their attached callback functions. 
Compound objects are implemented with a simple 
mechanism. Editable objects such as edit or combo boxes 
and objects with a state such as radio buttons can have 
data structures attached to them. These data strutures are 
constantly updated by the toolkit to reflect the value or state 
of the object. There are over 40 primitive objects including 
balloon help, fountain fills, formatted text, 
meters, gauges, 3D buttons, edit fields 
with validation, color bitmaps, etc. This 
allows you to concentrate more on design, 
leaving the implementation details to us. 

FIELD VALIDATION 

COBOL-like patterns, real time validation, range checking, 
large number of data types such as money, text, date, and 
time, and international language support make it the most 
powerful data entry package on the market. 

HELPIT 

Paragraph tags, hypertext, and a lightning fast interpreter 
are the keys to instant help. 

Windows and Microsoft C/C++ are trademarks of Microsoft Corporation. 

Diamond Toolkit. Cockpit, Loadlt. and Helplt are trademarks of Klondike Software Inc. 


SERVER-CLIENT 

Using only three functions (attach, locate and send) 
server-client architectures can be implemented in no time 
using a proven message passing mechanism. 

COCKPIT “ 

With Cockpit, the advanced workbench and revision control 
system, you are only three clicks away from your first 
Windows application. Cockpit handles resource, make, 
include, definition, and source files. You only have to deal 
with functions and projects. That’s easy! 

LOADIT “ 

The powerful installer requires no compilations for gene¬ 
rating setup configurations. Loadlt supports dialog boxes, 
paragraph tags, bitmaps, background fountain fills, etc. Use 
it to build simple applications too! 

PARSER & MORE ... 

There is more to Windows programming than dialog boxes. 
Diamond toolkit offers a complete set of tools that covers: 
parsing, DLLs, printing, DDE, file access, memory 
management, dialog box editor support, scrolling, dragging 
and resizing objects, keyboard events, clipboard support, 
animation, application profile, date and time conversion, 
timers, cursors, carets, debugging, tracing, 3D look, etc. 

VALUE 

The Diamond Toolkit is seven packages 
in one: Cockpit, Revision control, Loadlt, 

Helplt, Field Validation, Gadget library, 
and the actual toolkit with source code. 

This represents over $2000 worth of tools 
for the price of $395! 

If you want the most complete 
and simple to use Windows 
toolkit see your dealer today 
or call this number now: 




Klondike Software Inc. 

2700 Regina Street 
Ottawa, Ontario 
Canada K2B 6Y1 
Fax: 613 820-8299 

613726-6565 
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Listing 3 demortc.c — Demonstrate real-time clock routines 

/* Title: DEMORTC.C 

case 3: elk hertz * 4096; 

* Author: John Reynolds * 

Enabl eRtcInts(Hz4096); 

* Purpose: Exercise the Real-time clock routines * 

break; 

* contained In rtclock.c. * 

default: elk hertz = 128; 

* Copyright 1991 Magnetic Technologies Corporation * 

EnableRtcInts(Hzl28); 

* Rochester, New York 14625 */ 

break; 


} /* switch */ 

# include <conio.h> 


linclude <stdio.h> 

/* wait for time to expire */ 

llnclude "rtclock.h" 

while (RtcSeconds < endsec) 

static Int elk hertz, RtcSeconds; 

printf("%5d *5d\r",RtcCounter,RtcSeconds); 

static void rtc_timer(); 

} /* while */ 

void main() 

/* print ending time */ 

< 

printf("*5d %5d\r",RtcCounter,RtcSeconds); 

long int endsec; 


char cmd - 'X'; 

/* turn off real-time clock interrupts */ 


DisableRtcInts(); 

while(cmd 1- 'Q') 


f 

/* beep end of test */ 

clrscr(); 

sound(800) ; 

printf("Run for how many seconds ? "); 

del ay(10); 

scanf("%ld",&endsec); 

nosound(); 

printf("\nSelect clock speed: [1] 128 Hz, (2) “ 


■ 1024 Hz, (3) 4096 Hz >» "); 

fflush(stdin); 

scanf("%d",&clk hertz); 

printf("\n\nHit ant key to continue, or 'Q' to end. . ."); 


cmd - toupper(getch()); 

printf("\nHit any key to start timer. . ."); 

} /* while I'Q' */ 

getch()i 

( /* main() */ 

printf("\n\nStop at %d seconds\n",endsec); 

/*.*/ 

puts(“Rtclock RtcSeconds"); 

static void rtc_timer() 

/* designate interrupt handling routine */ 

RtcCounter++; 

NewRtcVec - rtc timer; 


RtcCounter - RtcSeconds - 0; 

if (RtcCounter -- clk_hertz) 

/* turn on real-time clock interrupts */ 

I 

RtcCounter - 0; 

switch(clk hertz) 

RtcSeconds++; 

i 

} /* if second passed */ 

case 2: elk hertz - 1024; 

} t* rtc timer() */ 

EnableRtcInts(Hzl024); 

/* End of File */ 

break; 
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a velocity profile is a plot of the velocity 
of the motor shaft (in steps per second) 
as a function of time, and is composed 
of three segments: acceleration, con¬ 
stant velocity, and deceleration. In order 
to describe the start-to-stop motion of 
a stepper motor, you must specify 
values for the acceleration, the constant 
velocity, and the total number of motor 
shaft steps. Two assumptions are made: 
the acceleration and deceleration values 
are the same, and the number of steps 
requested is large enough to allow the 
motor enough time to attain the re¬ 
quested constant velocity. An in-depth 
discussion of the criteria for selecting 
motion parameter values is beyond the 
scope of this article, but as a rough 
starting point you can use the following 
formulas: 

Velocity (STEPS/SECOND) 

= 1.5 x steps_to_move / 

tota1_move_time_a11 owed, 
Acceleration (STEPS/SEC/SEC) 

= 4.5 x steps_to_move / 

total_move_time_al1 owed. 

You may have to compromise the 
calculated values to achieve acceptable 
results because of physical motor or 
clock source limitations that prevent 
you from realizing the desired velocities 
or accelerations. The demonstration 
program presented here provides a 
mode of simulation that is useful in 
determining clock frequency limitations. 
By setting the global boolean variable 
sound_on, motor steps are simulated 
with speaker clicks. Failure to make the 
requested number of simulated steps in 
this mode indicates clock source limita¬ 
tions independent of motor limitations. 

System Implementation 

Calling move_stepper() in stepisr.c 
(Listing 7 — Listing 8, stepisr.h, is the 
header file) starts the data acquisition 
system. This function accepts three 
parameters specifying the motion 
parameters of the motor and one 
parameter specifying the frequency of 
the real-time clock. Based on this infor¬ 
mation, move_stepper() calculates the 
velocity profile of the motor move and 
executes each section of the profile 
with separate calls to profile_seg- 
ment_move(). This function installs 
Rtc_profile_segment_move() to be 
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Listing 4 printdio.h - Digital I/O interface header 
file 


/* Title: PRINTDIO.H * 

* Author: John Reynolds * 

* Purpose: Provide Digital I/O to outside world * 

* via parallel port. * 

* Copyright 1991 Magnetic Technologies Corporation * 

* Rochester, New York 14625 */ 

#ifndef PRINTDIO_H 
Idefine PRINTDIO_H 
/* 

PC Parallel Cable Pin Assignments: 



D I 6 

I T A L C 

i U T P U 

T 

Pin 

Printer Use 

Output Bit 

Pin 

Printer Use 

2 

Data Bit 0 

0 

18 

Ground 

3 

Data Bit 1 

1 

19 

Ground 

4 

Data Bit 2 

2 

20 

Ground 

5 

Data Bit 3 

3 

21 

Ground 

6 

Data Bit 4 

4 

22 

Ground 

7 

Data Bit 5 

5 

23 

Ground 

8 

Data Bit 6 

6 

24 

Ground 

9 

Data Bit 7 

7 

25 

Ground 


D I G 

I T A L I 

N P U T 


Pin 

Printer Use 

Input Bit 

Pin 

Printer Use 

1 

Strobe 

0* 

18 

Ground 

14 

Auto Feed 

1* 

19 

Ground 

16 

Initialize 

2 

20 

Ground 

15 

Error 

3 

21 

Ground 

13 

Select 

4 

22 

Ground 

12 

Paper Out 

5 

23 

Ground 

10 

Acknowledge 

6 

24 

Ground 

11 

Busy 

7* 

25 

Ground 

* Note: 

Code converts 

active low 

inputs to active high 


*/ 

/*.PARALLEL PORT SELECTION.*/ 

int use_port_LPT(unsigned char number); 

/* Eg. use_port_LPT(2) for LPT2 */ 

/* returns 0 if port unavailable */ 

/*— OUTPUT ROUTINES ---*/ 
void clear_all_bits(); 
void set_all_bits(); 
void set_bit(unsigned char bit0_7); 
void clear_bit(unsigned char bit0_7); 
void set_bit_pattern(unsigned char pattern); 

/* bits = 1 in mask will be affected, 
others left unchanged */ 

void set_masked_bits(unsigned char mask); 
void clear_masked_bits(unsigned char mask); 

/* return current output settings */ 
unsigned char read_output_byte(); 

/* return 0 if bit is low, 1 if high */ 
unsigned char read_output_bit(unsigned char bit0_7); 

/*- input ROUTINES -*/ 

unsigned char input_byte(); 

/* return 0 if bit is low, 1 if high */ 
unsigned char input_bit(unsigned char bit0_7); 
lendif 

/* End of File */ 


Listing 5 printdio.c - Digital I/O parallel port 
interface routines 


/* Title: PRINTDIO.C * 

* Author: John Reynolds * 

* Purpose: Provide Digital I/O to outside world * 

* via parallel port. * 

* Copyright 1991 Magnetic Technologies Corporation * 

* Rochester, New York 14625 */ 

linclude “printdio.h" 
linclude <dos.h> 

static unsigned int active_port; 

/*. - .*/ 

int use_port_LPT(unsigned char number) 

{ 

/* bios memory info: 408h » address of LPT1 port 
40Ah ■ address of LPT2 port 
40Ch = address of LPT3 port */ 
if (number > 3) return 0; 

active_port « peek(0x00, 0x0408 + 2*(number - 1)); 
return active_port; 

) /* use_port_LPT() */ 

/*.*/ 

void clear_all_bits() 

( 

if (active_port) 

outport(active_port, 0x00); /* all pins - 0 VDC */ 

) /* clear_all_bits() */ 

/*.*/ 

void set_all_bits() 

{ 

if (active_port) 

outport(active_port, OxFF); /* all pins = 5 VDC */ 

) /* set_all_bits */ 

/*.*/ 

void set_bit(unsigned char bit0_7) 

{ 

if (active_port) 

set_masked_bits(0x01 « bit0_7); 

) /* turn_on_bit() */ 

/*.-.*/ 

void clear_bit(unsigned char bit0_7) 

{ 

if (active_port) 

clear_masked_bits(0x01 « bit0_7); 

} /* turn_off_bit() */ 

/* .*/ 

void set_bit_pattern(unsigned char pattern) 

{ 

if (active_port) 
outportb(active_port, pattern); 

) /* set_bit_pattern() */ 

/*.*/ 

void set_masked_bits(unsigned char mask) 

/* bits « 1 in mask will be set, 
others left unchanged */ 

( 

if (active_port) 

outportb(active_port, mask | inportb(active_port)); 
} /* set_masked_bits() */ 

/*.*/ 

void clear_masked_bits(unsigned char mask) 

/* bits = 1 in mask will be cleared, 
others left unchanged */ 


Page 14 - Windows/DOS Developer’s Journal 


March 1993 



















called as part of the real-time clock periodic interrupt. 
Rtc_profile_segment_move() uses the technique of digital 
differential analysis (DDA) to generate the precisely timed 
series of pulses required at the STEP and DIRECTION inputs of 
the stepper motor controller. 

The key element of DDA is a precise clock source, which is 
provided in this system by the PC-AT real-time clock. The 
routine used here is adapted from a DDA implementation in 
Computer Control of Machines and Processes, by John G. Bol¬ 
linger and Neil A. Duffie [5], 

Once move_stepper() is called, the stepper motor remains 
in motion until the requested number of steps have been 
completed, or until one of two external events takes place. 


The operator may halt motor rotation by hitting any key on 
the keyboard, which sets the global boolean variable 
keybreak. In addition, the motor will stop if either of two 
protective limit digital inputs goes high. As shown in Figure 2, 
these limit signals are tapped off the clockwise and 
counterclockwise limit lines that are input to the stepper 
motor controller. These signals are supplied through switches 
that indicate that the stepper has reached a physical limit in 
the system that prevents safe rotation in the requested direc¬ 
tion. The data acquisition system described here does not use 
this feature, but the ability to monitor ends of travel is essen¬ 
tial to any system in which attempting to drive the motor 


Listing 5 continued 


if (active_port) 
outportb(active_port, 

(mask A Oxff) S inportb(active_port)); 

) /* clear_masked_bits() */ 

/*.*/ 

unsigned char read_output_byte() 

/* returns current output settings */ 

f 

if (active_port) 
return inportb(active_port); 
else return 0; 

} /* read_outputs() */ 

/*.*/ 

unsigned char read_output_bit(unsigned char bit0_7) 
/* return 0 if bit is low, 1 if high */ 

{ 

if (active_port) 

return(inportb(active_port) & (0x01 « bit0_7) 

? 1 : 0 ); 

else return 0; 

} /* read_output_bit() */ 

/*.*/ 

unsigned char input_byte() 

/* read printer ports and twiddle the bits */ 

{ 

unsigned char inbyte; 

if (active_port) 

{ 

/* Read STATUS port, keep bits 7,6,5,4,3 */ 
inbyte = inportb(active_port + 1) & 0xf8; 

/* Read CONTROL port, keep bits 2,1,0 */ 
inbyte |= inportb(active_port + 2) & 0x07; 

/* convert active low inputs to active high */ 
inbyte A = 0x83; 

return(inbyte); /* return input byte */ 

} /* if active_port */ 
else return 0; 

) /* input_byte() */ 

/*.*/ 

unsigned char input_bit(unsigned char bit0_7) 

/* return 0 if bit is low, 1 if high */ 

{ 

if (active_port) 

return( input_byte() & (0x01 « bit0_7) ? 1:0); 
else return 0; 

} /* input_bit() */ 

/* End of File */ 


Listing 6 demodio.c — Test parallel port digital I/O 
routines 


/* Title: DEMODIO.C * 

* Author: John Reynolds * 

* Purpose: Test parallel port Digital 1/0 routines * 

* Copyright 1991 Magnetic Technologies Corporation * 

* Rochester, New York 14625 */ 

finclude "printdio.h" 
linclude <conio.h> 

void main() 

( 

int i, LPTport; 
char choice = 'x'; 

clrscrO; 
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past a physical constraint could lead to motor or fixture 
damage. 

Three global Boolean variables monitor end-of-travel condi¬ 
tions: eot_cw_stop (“cw” for clockwise), eot_ccw_stop (“ccw” 
for counterclockwise), and eot_stop_ptr, which is a pointer to 
eot_cw_stop or eot_ccw_stop, depending upon which direc¬ 
tion the motor has been asked to move. The direction of the 


move is specified in the sign of move_stepper()'s velocity 
parameter; a positive value indicates clockwise rotation, and a 
negative value indicates counterclockwise rotation. 

One final signal that is monitored is the mechanical home 
input. This signal provides an absolute reference point for 
shaft positioning by going high whenever a predefined shaft 
position is attained. The signal is generated by the stepper 


Listing 6 continued 


puts(“\nAvalable LPT ports:\n"); 
for (i=0; i<3; i++) 

printf(”LPT%d= %04x\n",i+l, peek(0x00,0x0408 +i*2)); 

printf("\nUse which LPT port (1-3): “); 
scanf(“%d“,&LPTport); 

if (!use_port_LPT(LPTport)) 

{ 

printf(''\nLPT%d port unavailable !!\n\n“, 

LPTport); 

exit(); 

) /* if bad port */ 

while (toupper(choice) != ‘Q 1 ) 

{ 

clrscrf); 

printf("Using LPT%d\n\n“,LPTport); 
puts(“INPUTS ARE UPDATED WITH EACH CHOICE"); 
printf(”\n Input byte = %02x\t\t\t" 

■ Output byte = %02x\n" 

,input byte(), read output byte()); 
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printf(“ Input bit: 7654321 0\t\t“ 

“ Output bit: 7654321 0\n" 

" Currently:"); 
for (i=7; i>=0; i--) 
printf(" %d“, input_bit(i)); 
printf(“\t\t Currently:"); 
for (i=7; i>=0; i--) 
printf(" %d", read_output_bit(i)); 

puts(“\n\n\nOUTPUT CHOICES"); 
puts("\n 1\) Clear all bits"); 
puts(“ 2\) Clear single bit 11 ); 
puts(“ 3\) Clear masked bits' 1 ); 
puts("\n 4\) Set all bits"); 
puts(“ 5\) Set single bit"); 
puts(“ 6\) Set masked bits' 1 ); 
puts(“\n 7\) Set bit pattern' 1 ); 

printf("\n Enter Choice number, or Q to quit: “); 
choice = toupper(getch()); 

switch(choice) 

{ 

case '1': 
clear_al l_bits(); 
break; 
case '2': 

printf(“\nClear which bit (0-7)? ”); 
scanf(“%d",&i); 
clear_bit(i); 
break; 
case '3': 

printf(“\nEnter mask byte (hex) to clear " 
"(l's cleared, O's unchanged): “); 
scanf C'%x",&i); 
clear_masked_bits(i); 
break; 
case '4': 
set_all_bits(); 
break; 
case '5': 

printf(“\nSet which bit (0-7)? "); 
scanf("%d",&i); 
set_bit(i); 
break; 
case '6': 

printf("\nEnter mask byte (hex) to set " 

"(l's set, O's unchanged): ''); 
scanf("%x",&i); 
set_masked_bits(i); 
break; 
case '7': 

printf(“\nEnter pattern byte ” 

"(hex) to output: "); 
scanf("%x",&i); 
set_bit_pattern(i); 
break; 

) /* switch i */ 

) /* while(choice) */ 

} /* main() */ 

/* End of File */ 
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Listing 7 stepisr.c - Stepper motor ISR routines 


/* Title: STEPISR.C 

* 

I 

* Author: John Reynolds 

* 

sound(500); 

* Purpose: Stepper Motor Control Using 

* 

nosound(); 

* Real Time Clock For Timing Source. 

* 

) /* if sound on */ 

* Stepper Motor routine was adapted from 

* 

else 

* 'Computer Control Of Machines and 

* 

( 

* Processes', by John G. Bollinger and 

* 

turn on bit(STEP); /* take step */ 

* Neil A. Duffie, Copyright 1988 by 

* 

turn off bit(STEP); /* reset step */ 

* Addison-Wesley Publishing Company. 

* 

) /* sound off *7 

* Intended for Instructional Value only! 

* 


* Copyright 1991 Magnetic Technologies Corporation 

* 

StepCount++; 

* Rochester, New York 14625 

*/ 

P -= (int)P; 

read io(StepCount); /* take all readings */ 

finclude <dos.h> 


) /* if overflow */ 

finclude <conio.h> 


) /* if (RtcCount < N) */ 

finclude "stepisr.h" 



finclude “rtclock.h" 


if (kbhitO) keybreak = TRUE; 

finclude "ioutils.h" 


} /* Rtc_profile_segment_move() */ 

BOOLEAN keybreak, sound on, mech home; 


t* .*/ 

BOOLEAN eot_cw_stop, eot_ccw_stop, *eot_stop_ptr; 


void profile segment move(int elk freq hz) 

( 

static float P, V, A; 


if ( *eot stop ptr || keybreak) return; 

static int N; 



static unsigned int StepCount; 


RtcCounter = StepCount = 0; 

NewRtcVec = Rtc profile segment move; 

/*.-.*/ 



void Rtc profile segment move(void) 

1 ~ 


switch(clk freq hz) 

/ 

i 

if (RtcCounter < N) /* don't take too many steps 

/ 

4 

case 128: EnableRtcInts(Hzl28); 

{ 


break; 

RtcCounter++; 


case 1024: EnableRtcInts(Hzl024); 

P += V; 


break; 

V += A; 


case 4096: EnableRtcInts(Hz4096); 

if ((int)P) /* +1 or -1 overflow */ 


break; 

( 


} /* switch */ 

if (sound_on) 
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motor control itself, based on a user- 
definable position in the controller 
memory. Although this demonstration 
system does not act on the global vari¬ 
able mech_home, it is available for 
general use as an instantaneous in¬ 
dicator that the motor has reached the 
mechanical home position. In practical 
use, the data acquisition system would 


perform after-the-fact analysis of the 
digital data collected in the digi- 
tal_values array (see Listing 9) to 
determine instances of mechanical 
home positioning. 

In order to make the interface easy to 
modify, all the input and output calls to 
printdio functions are made indirectly 
via the code in ioutils.c (Listing 9) and 


Figure 1 Printer port hardware interface circuit 
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ioutils.h (Listing 10). This allows the 
system presented here to be adapted 
for use with some other data acquisi¬ 
tion engine by merely modifying the 
function calls in the ioutils modules. 
Also note that due to the lack of an 
analog input facility in the printdio en¬ 
gine, analog input time is simulated in 
ioutils.c by a call to the Borland 
function delay(). You would replace 
this dummy call with a call to a true 
analog input function in systems that 
supported it. 

demostep.c (Listing 11) provides an 
interactive testing platform for running 
the stepper motor control and data ac¬ 
quisition system. 

Limitations and 
Enhancements 

I compiled the code presented here 
using Borland C++ 2.0 on an Everex 
Tempo 386/20 machine. My experimen¬ 
tation with the stepper motor control 
routines has been limited to testing fix¬ 
ture applications, which generally do 
not require high speed motor moves or 
complex series of moves. While the 
code may be adequate for more 
demanding applications, select areas of 
code are likely candidates for improve¬ 
ment. The DDA stepper motor control 
routine presented here for demonstra¬ 
tion purposes could be replaced by a 
more sophisticated routine capable of 
achieving higher performance. Time 
critical routines, especially within inter¬ 
rupt handling portions of the code, 
would best be served by assembly lan¬ 
guage programming. In fact, use of the 
real-time clock periodic interrupt 
operating at 4096 Hertz almost 
demands assembly coding for all but 
trivial applications. 

Some devices require handshaking 
signals from the PC in addition to the 
eight lines of output data. The standard 
printer is an example of this, and you 
can control such devices by using the 
digital input lines as they were original¬ 
ly intended (see printdio.h for signal 
descriptions). Pin 1 of the parallel-port 
connector, for example, is the strobe 
signal that the PC uses to inform the 
printer that data is available. Using the 
strobe line programmed for output in 
conjunction with any other input line 
would provide the facility for two-way 
handshake communication. 


Figure 2 Stepper motor control circuit 


See Figure One 



Counterclockwise Limit Switch 


Figure 3 Stepper motor velocity profile 
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Alternatively, you can use more than one parallel port 
simultaneously to provide for sixteen bits of input and output 
information. Such a configuration, used in conjunction with ex¬ 
ternal analog-to-digital conversion circuitry, may also provide 


the basis upon which to implement an analog input facility. I 
am convinced that the PC contains many "free” and powerful 
resources that lie waiting to be unleashed by the inventive 
mind! 


Listing 7 continued 


/* wait for interrupt routine to finish move */ 
while (!( (RtcCounter >- N) || keybreak || 
*eot_stop_ptr)); 

DisableRtcIntsO; 

while (kbhit(J) getch(); /* clear buffer */ 

} /* profile_segment_move() */ 

/* . */ 

unsigned int move_stepper ( 
long int steps, 
float velocity, 
float accel, 

int elk freq hz ) 

( 

int i, sum, N2; 

float P2, Al, Nl; 

unsigned int steps_moved = 0; 

keybreak * FALSE; 

/* validate frequency request */ 
if ( clk_freq_hz 1- 128 
&& clk_freq_hz 1= 1024 
&& clk_freq_hz 1= 4096 ) return 0; 

/* make sure motor safe to move */ 
eot_stop_ptr - 

(velocity < 0) ? &eot_ccw_stop : &eot_cw_stop; 
read_io(0); /* read eot_stop status */ 
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if (*eot_stop_ptr) return 0; 

/* Stop any potential sign problems - 
only velocity can be negative */ 
steps * (steps<0) ? -steps : steps; 
accel • (accel<0) ? -accel : accel; 

/* Calculate Velocity Profile */ 

V * velocity / clk_freq_hz; /* steps/tick */ 

Al = accel / elk freq hz / clk_freq_hz; /* steps/tick/tick */ 
Nl = (int)( V / Al );“ 

Nl - (N1<0) ? -Nl : Nl; 
sum = 0; 

for (i=1; i<=Nl; 1++) sum += i; 

N2 - (int)( (steps - 2*(int)(Al*sum)) / (N1*A1)); 

/* Get ready to go */ 

turn_on_bit(DIRECTION); /* clockwise motion */ 
if (V<0) /* counterclockwise motion */ 

( 

Al - -Al; 

turn_off_bit(DIRECTION); 

} /* if counterclockwise */ 

P - V - 0.0; 

/* Accelerate */ 

A - Al; 

N - Nl; 

profile_segment_move(clk_freq_hz); 
steps jnoved +* StepCount; 

/* Constant velocity */ 

A - 0.0; 

N • N2; 

profi1e_segment_move(clk_freq_hz); 
steps_moved += StepCount; 

/* Decelerate */ 

A - -Al; 

N - Nl; 

profile_segment_move(clk_freq_hz); 
stepsjnoved +• StepCount; 
return(steps_moved); 

} /* move_stepper() */ 

/* End of File */ 


Listing 8 stepisr.h - Stepper motor ISR routines 
header (He 


/* Title: STEPISR.H * 

* Author: John Reynolds * 

* Purpose: Stepper Motor Control Using * 

* Real Time Clock For Timing Control * 

* Copyright 1991 Magnetic Technologies Corporation * 

* Rochester, New York 14625 */ 

#ifndef STEPISRH 
Idefine STEPISR_H 

Idefine BOOLEAN int 
Idefine FALSE 0 
Idefine TRUE 1 

extern BOOLEAN keybreak, sound_on, mech_home; 
extern BOOLEAN eot_cw_stop,eot_ccw_stop, *eot_stop_ptr; 

unsigned int move_stepper ( 
long int steps, 
float velocity, 
float accel, 

int elk freq hz ); 

/* clk_freq_hz = 128, 1024, or 4096 ONLY!! */ 
lendif 

/* End of File */ 
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Listing 9 ioutils.c - Interface to digital I/O routines 


/* Title: IOUTILS.C * 

* Author: John Reynolds * 

* Purpose: Interface to Analog/Digital I/O being * 

* used in this specific system. * 

* Copyright 1991 Magnetic Technologies Corporation * 

* Rochester, New York 14625 */ 

finclude “ioutils.h" 
linclude “stepisr.h 11 
linclude “printdio.h" 

unsigned char digital_reads[READS_PER_BLOCK]; 
unsigned int analog_reads[READS_PER_BLOCK]; 

/*. */ 

int init_io(unsigned char device) 

{ 

if (use_port_LPT(device)==0) return -1; 

clear_all_bits(); 

return 0; 

} /* init_io() */ 

/*.*/ 

void turn_on_bit(unsigned char bit) 

{ 

set_bit(bit); 

) /* turn_on_bit() */ 

/*.*/ 

void turn off_bit(unsigned char bit) 

{ 

dear_bit(bit); 

) /* turn_off_bit{) */ 

/*.*/ 

static unsigned char dins; 
static unsigned int ain; 

/*.*/ 

int read_io(unsigned int stepnum) 

( 

if (stepnum > READS_PER_BLOCK) return -1; 

/* read digital inputs */ 
dins = input_byte(); 
digital_reads[stepnum] = dins; 
eot_cw_stop = dins & 0x01 « CWLIMIT; 
eot_ccw_stop = dins & 0x01 « CCWLIMIT; 
mechjiome » dins & 0x01 « MECHH0ME; 

/* read analog inputs */ 

del ay(5); /* simulated read time */ 
analog_reads[stepnum] = ain; 
return(0); /* all ok */ 

) /* read io() */ 

/* End of File */ 


TCP/IP for Windows 
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Listing 11 demostep.c - Demonstrate stepper motor data acquisition code 


/* * Title: DEMOSTEP.C 

* Author: John Reynolds 

* Purpose: Exercise the Stepper Motor Beta 

* Acquisition System. 

* Copyright 1991 Magnetic Technologies Corporation 

* Rochester, New York 14625 

linclude <conio.h> 
linclude <math.h» 

#include "stepisr.h" 
linclude "printdio.h" 
linclude "ioutils.h" 

unsigned stepsjnoved; 
long int steps; 
float velocity, accel, value; 
char cmd; 
int c1k_hertz; 

float getvalue(char param[10]); 

void main() 

( 

int 1, LPTport; 

steps - 400; /* default values */ 

velocity - 60; /* for 400 steps */ 

accel "180; /* in 10 seconds */ 

clk_hertz * 128; 
sound_on * TRUE; 

/* Select parallel port */ 
clrscr(); 

putsf\nAvalable LPT ports:\n"); 
for (i-0; i<3; i++) 
printfCLPTVd* *04x\n“,i+l, peek(0x00,0x0408 +i*2)); 

printf("\nUse which LPT port (1-3): "); 
scanf("*d",&LPTport); 

if (!use_port_LPT(LPTport)) 

( 

printf(“\nLPT*d port unavailable !l\n\n*, 

LPTport); 

exit(); 

) /* if bad port */ 

init_io(LPTport); 

while (TRUE) 

( 

clrscrO; 

printf("<C>lock Frequency - %d Hertz\n", clk_hertz); 
printf(*<T>oggle Sound [currently %s]\n\n“, 
sound_on ? “ON": "OFF"); 
printf("<S>teps * %ld\n", steps); 
printf("<V>elocity - %1.4f\n", velocity); 
printf("<A>ccel - %1.4f\n\n", accel); 
printf("Change which C,T,S,V,A, <R>un motor, " 

"or <Q>uit ? *); 

cmd * toupper(getch()); 
switch(cmd) 

( 

case 'C 1 : 

printf("\n\nSelect clock speed: [1] 128 Hz, (2)" 
" 1024 Hz, (3) 4096 Hz » "); 
scanf("Vd",&dk_hertz); 
switch(elk hertz) 

( 

case 2: clk_hertz - 1024; 
break; 

case 3: clk_hertz x 4096; 
break; 

default: dk_hertz - 128; 
break; 

) /* switch */ 
break; /* case C */ 
case 'T': 

sound jjn - !sound_on; 
break; /* case T */ 


case 'S': 

steps * (int) getvalue("Steps“); 
break; /* case S */ 
case 'V 1 : 

velocity * getvalue("Velocity"); 
break; /* case V */ 
case 'A *: 

accel x getvalue("Accel"); 
break; /* case A */ 
case 
exit(); 

break; /* case Q */ 
case ‘R': 

printf("\n\nExecuting Motor Move. . ."); 
stepsjnoved * 

move_stepper(steps, velocity, accel, 
clk_hertz); 

if (keybreak) puts("KEYBREAK STOP!"); 
else if (*eot_stop ptr) 

puts("END OF TRAVEL STOP!"); 

printf("\n%d software steps moved.\n", 
stepsjnoved); 

printf(“Hit any key to continue. . ."); 
getch(); 

break; /* case R */ 

) /* switch */ 

) /* while cmd */ 

) /* main() */ 

/*.*/ 

float getvalue(char param[10]) 

( 

char value[7]; 

printf("\n\nlnput new value for its » ".param); 

scanf(“%s",&value); 

return(atof(value)); 

) /* getvaluej) */ 

/* End of File */ 


Listing 10 ioutils.h — Header file for ioutils.c 


/* Title: IOUTILS.H 

* Author: John Reynolds 

* Purpose: Interface to Analog/Digital I/O being 

* used in this specific system. 

* Copyright 1991 Magnetic Technologies Corporation 

* Rochester, New York 14625 

lifndef I0UTILS_H 
Idefine I0UTILSH 

/*- assign digital output bits bO - b7 -*/ 

Idefine STEP 1 /* step output bit */ 

Idefine DIRECTION 2 /* direction output bit */ 

/*-assign digital input bits bO - b7-*/ 

Idefine CWLIMIT 6 /* clockwise limit input bit */ 

Idefine CCWLIMIT 7 /* countercw limit input bit */ 

Idefine MECHH0ME 2 /* mechanical home input bit */ 

Idefine READS_PER_BL0CK 1000 

extern unsigned char digitalj-eads[READS_PER_BL0CK]; 
extern unsigned int analog_reads[READS_PER_BL0CK]; 

int init_io(unsigned char device); /* return 0 = ok */ 

void turn_on_bit(unsigned char bit); 

void turn_off_bit(unsigned char bit); 

int read_io(unsigned int stepnum); /* return 0 x ok */ 

lendif 

/* End of File */ 
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Real-Time Programming 


Monitoring Hardware Interrupts 
in Real Time 

Guy Eddon 


Understanding hardware interrupts is important for programmers who deal 
with hardware devices such as the UART, disk controllers, and so on. This 
article presents a brief review of hardware interrupts on the PC and provides a 
simple program that monitors the Programmable Interrupt Controller (PIC) and 
displays, in real time, which hardware interrupts are enabled. 

Hardware interrupts allow the PC to communicate with peripheral devices. 
The PC architecture funnels all maskable hardware interrupts through the 
8259A PIC because the CPU has only two pins to notify it of hardware inter¬ 
rupts: one for maskable hardware interrupts, the other for nonmaskable 
hardware interrupts. Nonmaskable hardware interrupts, which are generated 
by critical system errors such as memory parity errors, arrive directly at the 
CPU without first traveling through the 8259A PIC. The 8259A PIC manages and 
prioritizes the maskable hardware interrupts as they occur. It then forwards 
all maskable hardware interrupts in an orderly fashion to the maskable 
hardware interrupt pin on the CPU. 

Hardware interrupts play a crucial, if unglamorous, role in the transfer of 
data between the CPU and peripheral devices. The hard disk and floppy disk 
controllers both use hardware interrupts to communicate with the CPU. So do 
the coprocessor, clock, keyboard, timer tick, and both serial ports. Many add¬ 
on devices — including most speech cards, scanners, faxes, mice, token ring 
cards, MIDI cards, and CD-ROM drives — also use hardware interrupts in one 
way or another. 



Managing Hardware Interrupts 

Maskable hardware interrupts fall into two categories: 
dedicated and shareable. A dedicated hardware interrupt is 
used exclusively by one device: an attempt by any other 
device to use that interrupt will invariably crash the 
machine. Devices that use shareable hardware interrupts al¬ 
locate an interrupt only when there is data to transmit, and 
release it as soon as the transmission is over. The ad¬ 
vantage of the shareable hardware interrupt is obvious: at 
different times, the same hardware interrupt can perform 
different functions, thus lessening the chance for a conflict 
between devices over hardware interrupts. 


Guy R. Eddon is president of Guy Communications, Inc., a computer consulting 
company specializing in customized Windows and DOS software. He can be 
reached at 30-07 Hey wood Avenue, Fair Lawn, NJ 07410 (201) 797-1567. 
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Figure 1 The HARDINT display and hardware interrupt map 
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-> Software redirected to IRQ2 


Note: IRQ 02 is the 

10 FREE 

-> Reserved 


slave hardware 
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interrupt which 

12 FREE 

-> Reserved 

services IRQ 08 

13 USED 

-> Numeric coprocessor 

through IRQ 15. 8086 

14 USED 

-> Fixed-disk controller 

and 8088 CPU's have 

15 FREE 

-> Reserved — 

eight IRQ's only. 
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Most of the time you do not have to 
worry about hardware interrupts, but 
under certain circumstances hardware 
interrupt conflicts can wreak havoc in 
your system. For example, if you 
upgrade your existing system by adding 
a new board, you may experience 
hardware compatibility problems, if so, 
you have probably created a hardware 
interrupt conflict. In such a case, you 
may be forced to pull out all the boards 
in your system and replace them one 
by one until you find which one caused 
the conflict. This is a case where the 
HARDINT utility (Listing 1) comes in 
handy: run HARDINT to find out which 
hardware interrupts are free. Then, con¬ 
figure the new board to use one of the 
remaining free hardware interrupts. 


What Is HARDINT? 

HARDINT is a TSR I wrote to monitor, 
in real time, the status of all the 
hardware interrupts on my computer. I 
got the idea for HARDINT after reading 
an article by Jim Kyle and chip 
Rabinowitz on the theory of hardware 
interrupts (Microsoft Systems Journal, 
5/89). At the time, I was working on an 
application and, as usual, I created a 
screen that displayed pertinent system 
data, including, in this case, the status 
of the hardware interrupts. To retrieve 
the hardware interrupt status informa¬ 
tion, I developed code to spy on the 
8259A PIC. More recently, I converted 
the “spy code" into a TSR. As a TSR, 
HARDINT is a powerful tool for research 
and learning: you can install HARDINT 


Windows Help Files 
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for Microsoft Windows applications. 


Figure 2 HARDINT display of Windows multitasking 
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and then run another application, spying on its usage of 
hardware interrupts in real time. 

Install HARDINT on your computer by typing "HARDINT”. If 
everything goes smoothly, HARDINT will not display any mes¬ 
sage, but simply return you to the command line. Instantly, 
the HARDINT display will appear in the upper right-hand corner 
of your screen (refer to Figure 1 for the HARDINT display and 
standard hardware interrupt map). Listed inside the HARDINT 
box to the left is the number of the hardware interrupt whose 
status is displayed on the right 

Testing HARDINT 

If you have a serial mouse connected to C0M1, then run the 
mouse driver and watch HARDINT modify the status of IRQ 
04 from “FREE" to “USED.” Then type “MOUSE OFF” to see HAR¬ 


DINT update the status of IRQ 04 to “FREE” again. If your 
mouse is connected to COM2, then HARDINT will modify the 
status of IRQ 03. 

Spy on Shareable Hardware Interrupts 

With HARDINT you can observe shareable hardware inter¬ 
rupts in motion. If you own a Sound Blaster Board, test HAR¬ 
DINT with their demo program DR, SBAITSO. Notice that only 
when the program speaks is the hardware interrupt allocated, 
and that it is freed as soon as the speech is done. Logitech's 
hand scanners work much the same way; only when you 
scan are the hardware interrupts in use. 

Spy on Graphic Programs 

With HARDINT and a secondary monochrome monitor at¬ 
tached to your computer system, you 
can spy on graphic programs. Type 
“MODE MONO” to switch to the 
monochrome monitor, then install HAR¬ 
DINT. HARDINT will automatically sense 
that it has been installed on the 
monochrome monitor, and will con¬ 
figure itself likewise. Type "MODE C080” 
to return to your regular screen. Now 
start the graphics program you wish to 
spy on. All information about hardware 
interrupt manipulations will be trans¬ 
ferred to your monochrome monitor. 

Spy on Windows 

Spying on Windows with HARDINT is 
possible only because HARDINT is a 
well-behaved TSR that continues to 
operate under Windows. You do need a 
secondary monitor on your machine 
though. As far as HARDINT is concerned, 
Windows is only a graphic application 
running under DOS. As you start and 
exit Windows, you can observe the al¬ 
location and deallocation of hardware 
interrupts. Type “MODE MONO” to switch 
to the monochrome monitor, then in¬ 
stall HARDINT and type “MODE C080” to 
switch back to the standard monitor. 
Make sure your DOS mouse driver is in¬ 
stalled, then start Windows. Now, 
watch as Windows frees IRQ 04 from 
the clutches of the DOS driver and then 
immediately allocates it with the Win¬ 
dows mouse driver. To see the Win¬ 
dows multitasking mechanism in action, 
run Windows in enhanced mode. Open 
a DOS box. Inside the DOS box, install 
another copy of HARDINT, then type 
"MOUSE OFF.” Immediately, on the 
secondary monitor, IRQ 04 starts alter¬ 
nating between “FREE” and "USED.” This 
happens because IRQ 04 is free when 
Windows is servicing the DOS box, but 


Your future' 
These Windows. 






Today, more developers and programming groups 
are turning to Codewright as their vehicle to the 
future — a future developing in Microsoft Windows. 
You can configure and extend Codewright to work 
the way you work, the way your group works. At 
the same time, Codewright is truly at home in the 
Windows environment. 

Codewright has features to make 
even the best editors envious: Hex 
Edit, Selective Display, Multi-file 
Search and Replace, Difference 
Analysis, Customizable Tool Button 
Bar and Tool Box, File Merging and 
ChromaCoding. We’ve included the 
features you have come to rely on, 
too: Unlimited Undo/Redo, Column 
Marking, Language Templates, 

Compile and Find Errors. And 
Codewright has unsurpassed support 
for Windows v3.1. 

You configure Codewright to your 
preferences through its extensive 
system of dialogs, or by editing its 
initialization file. 



pumirc 


The professional Programmer’s 
Editor for Microsoft Windows. 


You extend Codewright through Dynamic Link 
Libraries (DLLs). Forget those half-hearted C 
macro languages. We provide the C source code 
to our DLLs for you to modify as you please. Or 
you can use any of Codewright’s 600 functions 
in your own DLL that you create with any 
Windows compatible language. 

To see your future in Windows, you 
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Listing 1 


// HARDINT.C written by Guy Eddon, 1992 

1 

// Monitors herdwere interrupts in reel time 

while(*str) 

// Microsoft C 6.0 

moutchar(x++, y, *str++, attr); 

// cl /Gs hardint.c /link /NOE 

) 

♦include <dos.h> 

// Output a character at specified X,Y coordinates 

♦include <conio.h» 

void far moutchar(int x f int y, char ch, unsigned char attr) 

/ 

♦define TICK 5 

I 

char far *v - vid_mem; 
v +- y * 160 + x * 2; 

void (interrupt far *old int8)(void); 

*v++ * ch, *v « attr; 

void far unsg to str(unsigned, char far *, int); 

i 

void far moutchar(1nt, int, char, unsigned char); 


void far mxyputs(int, int, char far *, unsigned char); 

void far box(int xl, int yl, int x2, int y2) 

void far box(int, int, int, int); 
void set vid mem(void); 

{ 

register int i; 

char cputypelvoid); 

char far *v, far *t; 
t * v ■ vid mem; 

♦define MK FP(seg.ofs) ((void far *) \ 

for(i * yl + 1; i < y2; i++) 

(((unsigned long)(seg) « 16) | (unsigned)(ofs))) 

{ 

♦define NORM VID 0x07 

v +* i * 160 + xl * 2; 

♦define NORM! VID OxOF 

*v++ - 186; 


*v * NORM VID; 

unsigned int status, bit, p8259, port[2] 1 ( 0x21, OxAl ); 

v ■ t; 

char col, buffer[3], tick - 0, far *vid_mem, cpu; 

v ♦- i * 160 ♦ x2 * 2; 

*v++ * 186; 

void interrupt far irq(void) 

*v - NORM VID; 

i 

if(++tick >« TICK) 

) 

( 

for(i ■ xl + 1; i < x2; i++) 

tick = 0; 

mxyputs(71, 1, “IRQ STAT\ NORMI VID); 

( 

v +* yl * 160 + i * 2; 

box(70, 0, 79, cpu < 2 ? 11 : 19j; 

*v++ - 205; 

moutchar(70, 2, (char)199, NORM VID); 

*v - NORM VID; 

for(col - 71; col < 79; col++) 

v ■ t; 

moutcharfcol, 2, (char)196, NORM VID); 

v +- y2 * 160 + i * 2; 

moutchar(79, 2, (char)182, NORM VIDj; 

*v++ * 205; 

for(col * 3, p8259 ■ 0; p8259 < (cpu < 2 ? 1 : 2); 

*v ■ NORM VID; 

p8259++) 

V - t; 
i 

status ■ inp(port[p8259]); 

i 

moutchar(xl, yl, (char)201, NORM VIO); 

for(bit * 0; bit <- 7; bit++) 

moutchar(xl, y2, (char)200, NORM VID); 

( 

moutchar(x2, yl, (char)187, NORM VID); 

unsg to str(bit + p8259 * 8, buffer, 2); 

moutchar(x2, y2, (char)188, NORM VID); 

mxyputsT71, col, buffer, NORMI VID); 

1 

if((status » bit) 6 1) 


mxyputs(73, col++, " FREE", NORM VID); 

void far unsg to str(unsigned i, char far f[], int 1) 

else 

( 

mxyputs(73, col++, " USED’, NORMI VID); 

int k * 1 - 1, h; 

) 

for(h =0; h < 1; h++) 

/ 

} 

l 

f[k—] = i V 10 + 0x30; 

chain intr(old int8); 

) 

i /- 10; 

) 

f[l] - 0; 

main() 

1 

set vid mem(); 

// Determines the cpu type 

cpu - cputypeO; 

char cputype(void) 

disable(); 

( 

old int8 - dos getvect(8); 

asm 

dos setvect(8, irq); 

( 

enable)); 

pushf 

dos keep(0, 185); 

mov ax,0 

) 

push ax 
popf 

// Set proper address of video RAM 

pushf 

void set vid mem(void) 

pop AX 

( 

and AH.OFOh 

union REGS r; 

cmp AH.OFOh 

int vmode; 

jne L2 

r.h.ah - 15; 

mov ax,0 

vmode - int86(0xl0, &r, &r) 6 255; 

push SP 

vid mem - (char far *)MK FP(vmode ** 7 ? OxBOOO : 0x8800, 0000); 

pop BX 

) 

cmp BX.SP 
jne LI 

// Output a string at specified X,Y coordinates 

jmp L3 

void far mxyputs(int x, int y, char far *str, unsigned 

L2: mov AX.OFOOOh 

char attr) 

push AX 
popf 
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Listing 1 continued 

pushf 


pop 

AX 

and 

AH.OFOh 

mov 

AX,2 

jz 

LI 

L3: inc 

AX 

LI: popf 

) 


/ 

setenvpO 

I 


_setargv() 


) 


/* End of File */ 


is used when Windows is servicing the Windows mouse driver 
(see Figure 2 for a static depiction of this dynamic situation). 
Thus, HARDINT can demonstrate the thoroughness with which 
Windows multitasks DOS boxes. 

HOW HARDINT Works 

To obtain a good technical explanation of TSR programming 
in C, refer to Undocumented DOS by Andrew Schulman et al. 
Listing 1 — HARDINT.C —comprises the entire HARDINT TSR. 
HARDINT works by interrogating the 8259A PIC. When you first 


install HARDINT, it chains into software interrupt eight, the 
timer tick. From then on, HARDINT checks the status of the 
8259A PIC every five timer ticks. To have it checked more or 
less often, modify the definition of TICK in Listing 1. HARDINT 
can be compiled with Microsoft’s C Compiler version 5.1 or 6.0, 
using the directions found at the top of Listing 1. Be aware 
that any modifications you make will require changing the 
second parameter passed to the _dos_keep function in Listing 
1. This must be done to adjust the amount of memory kept 
for the TSR. 

Summary 

HARDINT is a tool with many applications. It can aid in 
debugging problems with serial ports, or communication with 
any peripheral device. In any situations where hardware inter¬ 
rupt information could be useful, it is worth running HARDINT 
to see what you come up with. If you discover anything inter¬ 
esting with HARDINT, I would appreciate hearing about it. 
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Child Window Dragging Made Easy; 
Handling Control-Break; 

Creating a “Ghost Frame” 

Q Does either Control-C or Control-Break generate an interrupt under Win¬ 
dows 3.1? The toolhelp function InterruptRegisterf) does not have any in¬ 
terrupt corresponding to Control-C or Control-Break. 

I would like to be able to stop a program when the user hits one of those key 
combinations. I do not want to have to check the input queue, but want to handle it 
like it is done on UNIX systems, by setting up a signal handler for SIGINT. 

Is it possible? How? 

Nigel D'Souza 
nigeld@natinst.com 
National Instruments, Austin, TX 

A Unlike UNIX, Windows does not in general handle special keyboard combina¬ 
tions like Control-C or Control-Backslash. But it turns out that Control- 
Break is an exception. As explained in Undocumented Windows (Schulman, Maxey, 
and Pietrek:Addison-Wesley, 1992), the keyboard driver calls the undocumented ker¬ 
nel export DoSignal() when it detects a Control-Break. DoSignal() looks up the 
current focus window and current task, and calls a callback whose pointer is stored 
in the task’s database (TDB) block. Unfortunately, the range of calls available to the 
task's callback is extremely limited. Even though Windows enhanced mode imple¬ 
ments a preemptive multitasking operating system among virtual machines, it is 
non-reentrant. This means that in an interrupt situation, as you have when the 
callback function is called from DoSignalf), you cannot call any API function that 
will reenter the low-level operating system software (i.e., the virtual machine 
manager). As far as I know, the only API function you can safely call is Post- 
Message (). 

What this all means is that even if you resort to exploiting undocumented 
functionality to replace the task's callback with your own, you cannot handle the 
Control-Break when it happens. The best you can do is wait until control has 
returned to your application after the callback returns, at some unspecified future 
time, and handle the situation then. So you might as well just look for Control - 
Break at the level of your message loop since at least you are practicing safe coding. 


Paul Bonneau 


Send questions to Paul via Internet 
as paul@rdpub.com- 
from CompuServe: 

> INTERNET: pau l @rdpub. com-, 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743. 


Q l am trying to draw a frame similar to the "ghost frame” Windows draws when 
you move a window by dragging the caption bar. I am having problems, how¬ 
ever. 

Even on a 24-bit display this frame appears to be dithered. I cannot find a pen 
style and color to draw the same pattern. I suppose the width and height of the 
frame are SM_CXFRAME and SM_CYFRAME, respectively. 

Or do I have to draw two rectangles and fill the gap in between with a specific 
pattern? 

Jan Schiefer 
jan@nasobem.stgt.sub.org 


Paul Bonneau is a Senior Software Design Engineer at a major software firm. He was 
a developer of HyperChem, a molecular modeling system marketed by Autodesk. 






















Listing 1 dragdemo.c 

!*****************************************************i 

/* dragdemo.c */ 

/* — Demonstrate outline dragging. */ 

DeleteObject(hbrsDither) ; 
return wVal ; 

} 

LRESULT CALLBACK 


lindude <windows.h> 


LMainWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

char szApp[] = “DragDemo"; 

LPARAM IParam) 


HBRUSH hbrsDither; /* Dithered gray brush. */ 

y *****************************************************j 


/* -- Main window procedure. 

*/ 

int rgwBits[] * /* Bits for dithered grah brush. */ 

y***************************************************** y 

{ Oxaa, 0x55, Oxaa, 0x55, Oxaa, 0x55, Oxaa, 0x55 ); 

( 

static RECT rect; /* Gray frame to drag. 

*/ 

LONG CALLBACK LMainWndProc(HWND, UINT, WPARAM, LPARAM) ; 
void PaintRect(HDC, RECT *); 

switch (wm) 

{ 

default: 


int PASCAL 


WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

break; 


LPSTR lszCommand, int wShowWindow) 
y*********^*******************************************y 

case WM SIZE: 


/* — Entry point. */ 

rect.left = LOWORD(lParam) / 4; 


J ****★****★*★★*★★*★★*★★★*★★*★*****★★**★*★★★★★*★***★*★★ / 

rect.top ■ HIWORD(IParam) / 4; 


( 

rect.right « 3 * rect.left; 


HWND hwnd; /* Main window. */ 

rect.bottom = 3 * rect.top; 


HBITMAP hbmp; /* Bitmap for patterned brush. */ 

break; 


int wVal * 0; /* Return value. */ 

case WM DESTROY: 


If (IhinsPrev) /* Regsiter a class first time. */ 

PostQuitMessage(O) ; 


{ 

break; 


WNDCLASS wcs; 

case WM PAINT: 


wcs.style = CS HREDRAW | CS VREDRAW; 

{ 


wcs.lpfnWndProc - LMainWndProc; 

PAINTSTRUCT wps; 


wcs.cbClsExtra « 0; 
wcs.cbWndExtra * 0; 

if (BeginPaint(hwnd, &wps)) 


wcs.hlnstance * hinsThis; 

{ 


wcs.hlcon ■ LoadIcon(hinsThis, szApp) ; 

PaintRect(wps.hdc, Srect); 


wcs.hCursor * LoadCursor(NULL, IDC ARROW); 

EndPaint(hwnd, &wps); 


wcs.hbrBackground = (HBRUSH)(COLOR WINDOW + 1); 

) 


wcs.lpszMenuName » szApp; 

} 


wcs.lpszClassName « szApp; 
if (!RegisterClass(&wcs)) 

return TRUE; 


return 0; 

case WM LBUTTONDOWN: 


) 

SetCapture(hwnd); 



/* Fall through. */ 


/* Create the patterened brush. */ 

if (hbmp = CreateBitmap(8, 8, 1, 1, rgwBits)) 

( 

hbrsDither = CreatePatternBrush(hbmp); 

case WM MOUSEMOVE: 

( 

HDC hdc; 


DeleteObject(hbmp); 



) 

if (GetCapture() == hwnd && (hdc » GetDC(hwnd))) 

if (1hbrsDither) 

{ 


return 0; 

int dx, dy; 


/* Create and show the main window. */ 

PaintRect(hdc, Srect); 


if (hwnd = CreateWindow(szApp, szApp, 

dx = rect.right - rect.left; 


WS OVERLAPPEDWINDOW, CW USEDEFAULT, wShowWindow, 

dy = rect.bottom - rect.top; 


CW USEDEFAULT, CW USEDEFAULT, NULL, NULL, 

rect.left ■ LOWORD(IParam) - dx / 2; 


hinsThis, NULL)) 

rect.top = HIW0RD(1Param) - dy / 2; 


( 

rect.right = rect.left + dx; 


MSG msg; /* For message pump. */ 

rect.bottom = rect.top + dy; 
PaintRect(hdc, Srect); 


ShowWindow(hwnd, wShowWindow); 

ReleaseDC(hwnd, hdc); 


UpdateWindow(hwnd) ; 

} 


while (GetMessage(&msg, NULL, NULL, NULL)) 

} 


{ 

break; 


TranslateMessage(&msg) ; 

DispatchMessage(Smsg) ; 

case WM LBUTTONUP: 


} 

ReleaseCaptureO; 


wVal = msg.wParam; 

break; 


) 

) /* End switch wm. */ 
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A Windows draws a “ghost frame" with four calls to Pat- 
Bit (). It uses a pattern brush created by the User 
module during its initialization that is a 50 percent dithered 
monochrome gray. The brush is drawn into each of the four 
rectangles that make up the frame using the PATINVERT raster 
operation code. This particular code instructs GDI to XOR the 
bits of the brush with the bits of the destination. Thus a pair 
of calls to PatBltf) will fill a rectangle with the gray brush, 
then restore the original bits of the destination. 

The width of each side of the frame appears to be one 
pixel less than the values returned from GetSystemMetrics() 
using the SM_CXFRAME and SM_CYFRAME values, but I suggest 
this from empirical observation only. 

Since a pattern brush is being used, it is important to pay 
attention to its origin. A brush's origin is really a property of 
the device context, not the brush itself. All pattern brushes 
are made from an 8x8 pixel array, so the origin of a brush is 

Listing 1 continued 


return DefWindowProc(hwnd, win, wParam, IParam); 

} 

void 

PaintRectfHDC hdc, RECT * prect) 

j★**★***★*★★*★★★★★*★**★★*★*****★*****★*★★******★*★★***j 

/* — Paint a rectangle on the screen. */ 

/* -- hdc : Display context to paint onto. */ 

/* — prect : Outline of rectangle to paint. */ 

j★★**★**★***★★★****★**★★*******************★*★**★*★**★j 

{ 

int dxBorder, dyBorder; /* Border thickness. */ 

int dxRect, dyRect; /* Frame dimensions. */ 

HBRUSH hbrsSav; /* Restore at exit. */ 

UnrealizeObject(hbrsDither); /* Reset origin */ 

if (!(hbrsSav = SelectObjectfhdc, hbrsDither))) 
return; /* Error. */ 

/* Compute dimesions. */ 
dxRect = prect->right - prect->left; 
dyRect = prect->bottom - prect->top; 
dxBorder » GetSystemMetrics(SM_CXFRAME); 
dyBorder = GetSystemMetrics(SM_CYFRAME); 

/* Top. */ 

PatBlt(hdc, prect->left, prect->top, 
dxRect, dyBorder, PATINVERT); 

/* Bottom. */ 

PatBlt(hdc, prect->left, prect->bottom - dyBorder, 
dxRect, dyBorder, PATINVERT); 

/* Left. */ 

PatBlt(hdc, prect->left, prect->top + dyBorder, 
dxBorder, dyRect - 2 * dxBorder, PATINVERT); 

/* Right. */ 

PatBltfhdc, prect->right - dxBorder, 
prect->top + dyBorder, dxBorder, 
dyRect - 2 * dxBorder, PATINVERT); 

SelectObject(hdc, hbrsSav); /* Restore DC. */ 

) 


/* End of File */ 
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Listing 2 dragdemo.def 



;; dragdemo.def ;; 

;; -- Linker definition file for DragDemo. ;; 

NAME 

DragDemo 

DESCRIPTION 

‘Outline dragging demo 1 

EXETYPE 

WINDOWS 

STUB 

■WINSTUB.EXE‘ 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

EXPORTS 

10240 

LMainWndProc @1 


Listing 4 dragdemo.mak - Project file for 
DragDemo app 


####################################################### 
## dragdemo.mak ## 

## -- Project file for DragDemo app. ## 

####################################################### 
all: dragdemo.exe 

dragdemo.obj: dragdemo.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT dragdemo.c 

dragdemo.exe: dragdemo.obj dragdemo.def dragdemo.rc \ 

makefile 

link /NOD/MA dragdemo,,, libw mlibcew, dragdemo.def 
rc $(DEFS) dragdemo 
mapsym dragdemo 


Listing 3 dragdemo.rc 


^★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★********************y 
/* dragdemo.rc */ 
/* — Empty resource file. */ 
j ★★**★**★★★*★★★★***★*★★★★★★***************★***★★*★*★**y 


an (x, y) value pair, with both x and y in the range of 0 to 7, 
inclusive. When a GDI procedure involving a pattern brush is 
made, the origin of the brush is used to align the brush with 
the device context. If two areas of the device context are 
painted using the same brush origin, the patterns will be 
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aligned, creating a smooth intersection if the areas abut or 
intersect. But if the origin of the device context changes, say 
by moving a window, and the origin of the brush is not reset, 
the brush pattern may be misaligned with previous output. 

The UnrealizeObject() function informs GDI to reset the 
origin of a pattern brush the next time SelectObject() is 
called to select it into a device context. Furthermore, the 
brush must be unselected when the call to Unrealize¬ 
Object () is made. This means that if you are using an owned 
DC (the window class was registered with the CS_0UNDC style), 
you must select the pattern brush out of the DC, reset its 
origin, and select it back in. 

The program DragDemo, implemented in dragdemo.c, drag- 
demo, def, dragdemo.rc, and the makefile (Listings 1 through 
4) demonstrates dragging a ghost frame. In its quiescent state, 
it draws a gray dithered frame in the center of the client area. 
If the user drags with the left button, the rectangle tracks the 
mouse (it stays centered over the mouse pointer). 

During initialization, an 8x8 bitmap for the dithered gray 
brush is created out of an array of 8 ints. You might wonder 
why ints are used instead of chars, since the bitmap being 
created is only 8 bits wide. The reason is that bitmaps must 
be padded to a multiple of 16 bits per scan line. After the 
pattern brush has been created, the bitmap it is based on can 
be discarded. 

When the user presses the mouse button in the client 
area, DragDemo captures the mouse in order to receive mouse 
messages even if the user drags off the client area. During a 
drag (i.e., when processing the UM_M0USEM0VE message), Get- 
Capture () is called to see if the mouse has been captured by 
DragDemo's main window. It is not enough to see if Get- 
Capture () returns non-null, since another application's win¬ 
dow may have stolen the mouse from underneath you! The 
check is unnecessary on the UM_LBUTTT0NUP message, since, 
first, getting the message at all means no other window has 
the mouse captured, and, second, even if DragDemo does not 
have the mouse captured, it is benign to call Release- 
Capture () in this case. 

PaintRectj) paints the ghost frame. There's not much to 
this routine. It resets the origin of the pattern brush, selects it 
into the DC, paints the four rectangles, and restores the 
original brush. 
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Q l would like to develop a toolbar for my research 
prototype project. The approach I am using is 
ownerdraw instead of subclassing (you explained this in the 
September '92 issue of WDDJ). During my experimentation I 
found that the responsiveness of the button is slow and very 
weird. If you click the mouse twice within a short time (does 
not mean DOUBLE clicks), the second click does not get 
processed. Enclosed [see Listing 5] is an excerpt from my win¬ 
dows procedure (in this example I even use FillRect(), 
which I thought should be a lot faster than BitBlt(), but the 
result is the same). 

Glenn Jayaputera 
gtj@goanna.cs.rmit.oz.au 
Dept, of Computer Science, 
Royal Melbourne Institute of Technology 
Melbourne, Australia 

A When I first looked at this code, I was concerned about 
returning 0 to the WM_ DRAW ITEM message. According to 
the SDK's on-line help: “An application should return TRUE if it 
processes this message." But experimentation indicates that 
the return value is ignored. Perhaps the documentation as¬ 
sumes that the control is part of a dialog; a dialog procedure 
should always return TRUE if it handles a message, to prevent 
the dialog manager from performing its default action. 

My second concern is with the body of IsButtonUpO. If 
the action is ODA_FOCUS, meaning the control has received the 
focus, the return value of IsButtonUpO is undefined. This 
could help explain strange behaviour, 
depending on the contents of the AX 
register when the function returns. A 
button will give itself the focus when 
clicked on, so you may be seeing er¬ 
ratic behavior depending on which win¬ 
dow has the focus when you click your 
button. 

The problem with two clicks in suc¬ 
cession is, I think, a double-click prob¬ 
lem after all. When the User module in¬ 
itializes, it registers the button class 
with the style 0x8b, which equates to 
CS_HREDRAW, CSJREDRAW, CSJARENTDC 
and CS_DBLCLKS (you can find out stuff 
like this by setting a breakpoint on 
RegisterClass() during Windows star¬ 
tup and examining the contents of the 
WNDCLASS pointer parameter). Because 
CS_DBLCLKS is specified, if the second 
click in a pair of clicks falls within the 
double-click time, a WM_LBUTTONDBLCLK 
message is sent to the button’s window 
procedure instead of a WM_LBUTTONDOWN. 

But no special action is taken for the 
double-click message, and the owner 
window is not called with a 
WM_DRAWITEM. You can prevent this, but 
you will have to subclass after all. All 
the subclasser has to do is convert 
WM LBUTTONDBLCLK messages back into 


Listing 5 Excerpt from Glenn Jayaputera's window 
procedure 


{ 


case WM_DRAWITEM: 

1pDIS = (LPDRAWITEMSTRUCT)lParam; 
if (!IsButtonUp(lpDIS->itemAction, 
lpDIS->itemState)) 

Fil 1Rect(lpDIS->hDC,&lpDIS->rcItem, 
GetStockObject(BLACK_BRUSH)); 

else 

Fi 11 Rect(1 pDIS->hDC,&l pDIS->rcItem, 
GetStockObject(LTGRAY_BRUSH)); 

return 0; 


BOOL 

IsButtonllp(WORD ItemAction, WORD ItemState) 
{ 

if ((ItemAction & ODA_SELECT) || 
(ItemAction & ODA_DRAWENTIRE)) 

{ 

if (ItemState & ODS_SELECTED) 
return TRUE; 

el se 

return FALSE; 

} 


) 
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UM_LBUTTONDOUNs and the owner window will get called for 

both clicks, ownrdraw.c (Listing 6) presents the code for a ^^In the December issue of Windows/DOS Developer's Jour- 
sample window procedure and subdasser. ^&Cnal, you responded to a reader’s inquiry (how to high- 


Listing 6 ownrdraw.c 


^*****************************************************/ 
/* ownrdraw.c */ 

/* — Demonstrate owner draw buttons. */ 

^*****************************************************y 

linclude <windows.h> 
linclude <windowsx.h> 

WNDPROC lpfnSav; /* Button's original wndproc. */ 
WNDPROC IpfnSubClass; /* Subclasser instance proc. */ 

Idefine cidPush 100 /* Push button control id. */ 

BOOL IsButtonUp(WORD, WORD); 

LRESULT CALLBACK LButtonSubClassProc(HWND, UINT, 

WPARAM, LPARAM); 

LRESULT CALLBACK MainWndProc(HWND, UINT, WPARAM, 

LPARAM); 

LRESULT CALLBACK 

MainWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 


/* — Main window procedure. */ 

y***************************************************** j 

i 

switch (wm) 



Secrets of Embedded Systems Revealed! 


Performance compares to commercial kernels 
Written in C with assembly code minimized 
Ports to any microprocessor with stack pointers 
Includes System Code & Users Manual 
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RD 
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default: 

break; 

case WM_CREATE: /* Create a button to test. */ 

( 

HWND hwndPush; 

if (!(hwndPush = CreateWindowC'button", NULL, 
WS_CHILD | WSJISIBLE | BS_0WNERDRAW, 

0, 0, 0, 0, hwnd, (HMENU)cidPush, 
GetWindowInstance(hwnd), NULL))) 
return -1; /* Destroy window. */ 

/* Subclass it using a nifty macro from */ 

/* windowsx.h. */ 

lpfnSav = (WNDPROC)GetWindowLong(hwndPush, 
GWL_WNDPR0C); 

SubclassWindow(hwndPush, IpfnSubClass); 

} 

break; 

case WM_SIZE: /* Button fills client area. */ 
SetWindowPos(GetDlgItem(hwnd, cidPush), NULL, 
0, 0, LOWORD(lParam), HIW0RD(1Param), 
SWP_N0ACTIVATE | SWP_N0M0VE | SWP_N0Z0RDER); 
break; 

case WM_DESTR0Y: /* Only for main window. */ 

PostQuitMessage(O); 
break; 

case WM_DRAWITEM: 

( 

LPDRAWITEMSTRUCT lpDIS; 

lpDIS = (LPDRAWITEMSTRUCT)IParam; 
if (!IsButtonUp(lpDIS->itemAction, 
lpDIS->itemState)) 

FillRect(lpDIS->hDC,&lpDIS->rcItem, 
GetStockObject(BLACK_BRUSH)); 

else 

FillRect(lpDIS->hDC,&lpDIS->rcItem, 
GetStockObject(LTGRAY_BRUSH)); 

} 

return TRUE; /* Apparently unheeded. */ 


return DefWindowProc(hwnd, wm, wParam, IParam); 


LRESULT CALLBACK 

LButtonSubClassProc(HWND hwnd, UINT wm, WPARAM wParam, 
LPARAM IParam) 

/ 


***************************************************** 


/ 

/* -- Turn double clicks into single clicks. */ 

J★*★★**★**★**★**★**★★★*******★★********★**************J 


( 

return CallWindowProc(lpfnSav, hwnd, 
wm == WM_LBUTT0NDBLCLK ? WM_LBUTT0ND0WN 
wParam, IParam); 

} 


wm. 


BOOL 

IsButtonUp(W0RD ItemAction, WORD ItemState) 

I***************************************************j 

/* -- Return TRUE if button is in selected state. */ 

/***************************************************** j 
{ 

if ((ItemAction & 0DAJELECT) || 


□ Request 337 on Reader Service Card □ 


Page 34 — Windows/DOS Developer’s Journal 


March 1993 






















light selected text in a list box) by suggesting he use an 
owner-draw list box. The code you offered does not take ac¬ 
count of a quirk (feature? bug?) peculiar to list boxes. When a 
list box is the first control in a dialog box tab-order, the 
caret/focus rectangle is not initially displayed. This means that 
simply using DrawFocusRect whenever Windows informs you 
that the focus has changed will not give the desired results 
because the list box item may have the input focus and yet 
not display the caret. 

I have developed an inelegant work-around which involves 
using GetPixelf) (the first time I’ve ever needed that func¬ 
tion!) to get the dialog box background color (it's that or cycle 
through parents, GetClassInfo() , and then distinguish a “real” 
background brush from a COLOR_xxxx 
constant). This allows me to erase an 
existing caret when the list box loses 
focus instead of using DrawFocusRect (). 

I'd welcome your comments. 

Nick Hunter 
CIS: 70632,2362 



(ItemAction & ODA DRAWENTIRE)) 

( 

if (ItemState & 0DS_SELECTED) 
return TRUE; 

else 

return FALSE; 

} 


return FALSE; 
} 

End of File */ 


/* Return something known. */ 


A rm glad you asked this question. I 
don't know how long I have been 
observing this behavior in certain 
dialogs. It’s one of those annoying little 
user interface quirks that just manage 
to stay below the threshold of making 
me curious enough to see just what the 
heck is going on. After some ex¬ 
perimenting I found that it only hap¬ 
pens to dialogs that do not have the 
US_VISIBLE style in their dialog 
templates. This is true regardless of 
whether the list box is created with one 
of the LBS_0WNERDRAW styles or not. If 
the dialog has the US_VISIBLE style, 
the caret is drawn, if not, no caret. 

It turns out the list box calls code to 
detect if the list box window and its en¬ 
tire ancestor chain of windows are 
visible. If this check fails, the list box 
does not call DrawFocusRect () for non- 
owner draw list boxes, or send a 
UM_DRAUITEM message with the focus 
notification for owner draw list boxes. 
When the dialog is created with the 
US_VISIBLE style, the dialog gets 
shown earlier in the creation cycle. 
When the style is absent, the dialog 
presentation is deferred so long that 
the test never passes. One might argue 
that this is a case of Microsoft over-op¬ 
timizing the window presentation code. 

In any event, if you ensure that all 
of your dialogs have the WS_VISIBLE 
style, you won't have to worry about 
emulating this bogus behavior. Besides, 
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Listing 7 childrag.c 


J*****************************************************J 

/* childrag.c */ 

/* — Child control dragging demo. */ 

j*****************************************************J 

lindude <windows.h> 
lindude <windowsx.h> 

#define cidButton 0x0100 

char szApp[] ■ "ChilDrag"; 

char szButton[] = “Button"; 

WNDPROC lpfnSubClass, lpfnSav; 

LRESULT CALLBACK LMainWndProc(HWND, UINT, WPARAM, 

LPARAM); 

LRESULT CALLBACK LSubClassProc(HWND, UINT, WPARAM, 

LPARAM); 

int PASCAL 

WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

LPSTR lszComroand, int wShowWindow) 

/* — Entry point. */ 

j*****************************************************j 

{ 

HWND hwnd; /* Main window. */ 

MSG msg; /* For message pump. */ 

WNDCLASS wcs; 

if (IhinsPrev) /* Register classes first time. */ 

{ 

WCS. Style = CS_HREDRAW I CS_VREDRAW; 
wcs.lpfnWndProc = LMainWndProc; 
wcs.cbClsExtra = 0; 
wcs.cbWndExtra = 0; 
wcs.hlnstance = hinsThis; 
wcs.hlcon = LoadIcon(NULL, IDI_APPLICATION); 
wcs.hCursor « LoadCursor(NULL, IDC_ARR0W); 
wcs.hbrBackground = (HBRUSH)(C0L0R_WIND0W + 1); 
wcs.lpszMenuName = NULL; 
wcs.lpszClassName ■ szApp; 
if (!RegisterClass(&wcs)) 
return 0; 

) 

if (!GetClassInfo(NULL, szButton, &wcs)) 

return 0; /* Something badly wrong. */ 

lpfnSav = wcs.lpfnWndProc; 

if (!(lpfnSubClass ■ (WNDPROC)MakeProcInstance( 

(FARPROC)LSubClassProc, hinsThis))) 
return 0; 

/* Create and show the main window. */ 

msg.message = 0; 

if (hwnd = CreateWindow(szApp, 

"Child dragging demo", WS_0VERLAPPEDWIND0W, 
CW_USEDEFAULT, wShowWindow, CW_USEDEFAULT, 
CW_USEDEFAULT, NULL, NULL, hinsThis, NULL)) 

{ 

ShowWindow(hwnd, wShowWindow); 
UpdateWindow(hwnd); 

while (GetMessage(&msg, NULL, NULL, NULL)) 

{ 

TranslateMessage(&msg); 
DispatchMessage(&msg); 

} 

} 


FreeProcInstance((FARPROC) lpfnSubClass); 
return msg.message; 

} 

LRESULT CALLBACK 

LMainWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

j*****************************************************J 

/* — Main window procedure. */ 

J*****************************************************J 

( 

switch (wm) 

{ 

default: 

break; 

case WM_CREATE: 

( 

HWND hwndChild; 

if (!(hwndChi1d = CreateWindow(szButton, 

"drag me", 

WS_CHILD I WS_VISIBLE | BS_DEFPUSHBUTTON, 

0, 0, 0, 0, hwnd, (HMENU)cidButton, 
GetWindowInstance(hwnd), NULL))) 
return -1; /* Destroy main window. */ 

SubclassWindow(hwndChild, lpfnSubClass); 

) 

break; 

case WM_SIZE: 

( 

int dx = L0W0RD(1Param); 
int dy = HIW0RD(1 Param); 

SetWindowPos(GetDlgItem(hwnd, cidButton), NULL, 
dx / 4, dy / 4, dx / 2, dy / 2, 

SWP_NOACTIVATE | SWP_N0Z0RDER); 

) 

break; 

case WM_DESTROY: 

PostQuitMessage(O); 
break; 

} /* End switch wm. */ 

return DefWindowProc(hwnd, wm, wParam, IParam); 

) 

LRESULT CALLBACK 

LSubClassProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

J*****************************************************j 

/* -- Button control subclasser. */ 

!*****************************************************! 

{ 

return wm == WM_NCHITTEST && 

GetKeyState(VK_SHIFT) < 0 ? 

HTCAPTION : 

CallWindowProc(lpfnSav, hwnd, wm, wParam, 

1Param); 

) 

/* End of File */ 
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Listing 8 childrag.def 



;; childrag.def ;; 

NAME 

Chi 1 Drag 

DESCRIPTION 

‘Child control dragging demo 1 

EXETYPE 

WINDOWS 

STUB 

'WINSTUB.EXE' 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

EXPORTS 

10240 

LMainWndProc @1 

LSubClassProc @2 


Listing 9 childrag. rc 


j*****************************************************j 

/* childrag.rc */ 

/* -- Empty resource file. */ 


using GetPixel () will have problems if part of the caret is 
off-screen or obscured by another window. 

Q l'm developing an application which consists of objects 
(not the OOPS parlance) called nodes. These nodes are 
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Listing 10 childrag.mak - Project file for Chi I Drag 
app 


####################################################### 
## childrag.mak ## 

## — Project file for Chi 1 Drag app. ## 

####################################################### 
all: childrag.exe 

childrag.obj: childrag.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT childrag.c 

childrag.exe: childrag.obj childrag.def childrag.rc \ 
makefile 

link /N0D/m chi 1 drag,,, libw mlibcew, \ 
childrag.def 
rc $(DEFS) chi 1 drag 
mapsym childrag 


rectangular in shape. They can be moved around the screen 
with the help of the mouse like the child controls of any 
dialog box editor. 

I create these nodes internally as child windows (styles 
US_B0RDER | US_CHILD). These child windows are required to 
process the UM_LBUTT0ND0UN, UM_LBUTTONUP, and UM_LBUT- 
TONDBLCLK messages. There's no problem with that. To move 
these child windows, since there is no caption, I process the 
UM_NCHITTEST message and return HTCAPTION. This is a con¬ 
venient method because I don’t have to repaint my main win¬ 
dow —Windows takes care of it. 
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The problem I'm facing is that I don't seem to be able to 
intercept the three mouse messages mentioned above. The 


Listing 12 idletsr.h — Command values for idleTsr 


y***************************************************** j 

/* idletsr.h */ 

/* — Comnand values for IdleTsr. */ 

I *****************************************************j 

Idefine cmdlsLoaded OxdOOO 

Idefine cmdldleCheck OxdOOl 

Idefine cmdTimerCheck 0xd002 


dock application in Windows and all the dialog box editors 
seem to have overcome this problem. 

Do the clock application and the dialog box editors use the 
same technique? What modifications must I make to still 
receive the mouse messages? 

Srikumar Chari 
chari@hpspam.corp.hp.com 
3000, Hanover St. 
P. 0. Box 10301, MS 20dt 
Palo Alto, CA 94303-0890 

A I like your approach. I have seen this same problem ad¬ 
dressed many times, and the usual answer is for the ap¬ 
plication to track all the mouse moves and either move the 


Listing 11 idletsr.c — TSR to detect idle interrupt 


^***************************************************** j 

/* idletsr.c */ 

/* — TSR to detect idle interrupt. */ 

/***************************************************** j 

linclude <dos.h> 
linclude <stdlib.h> 
linclude <malloc.h> 
linclude "idletsr.h" 


extern unsigned end; 

int wldleCount, wTimerCount; 


void (interrupt far 

* pfn0801d)(); 

/* 

Next 

in 

chain. 

*/ 

void (interrupt far 

* pfn2801d)(); 

/* 

Next 

in 

chain. 

V 

void (interrupt far 

♦ pfn2f01d)(); 

/* 

Next 

in 

chain. 

*/ 

void interrupt far 







Int28Handler(int es, 

, int ds, int di 


int si 

, i 

int bp, 



int sp, int bx, int dx, int cx, int ax, int ip, 
int cs, int flags) 

^***************************************************** j 

/* — Idle interrupt handler. */ 

y***************************************************** J 
{ 

wIdleCount++; 

_chain_intr(pfn2801d); 

I 

void interrupt far 

Int08Handler(int es, int ds, int di, int si, int bp, 
int sp, int bx, int dx, int cx, int ax, int ip, 
int cs, int flags) 

/A****************************************************/ 

/* -- Timer interrupt handler. */ 

j ***************************************************** j 

i 

wTimerCount++; 

_chain_intr(pfn0801d); 

I 

void interrupt far 

Int2fHandler(int es, int ds, int di, int si, int bp, 
int sp, int bx, int dx, int cx, int ax, int ip, 
int cs, int flags) 

/***************************************************** J 

/* — Multiplex interrupt handler. */ 

y***************************************************** j 

< 

switch (ax) 

{ 

default: 

_chain_intr(pfn2f01d); 
break; 


case cmdlsLoaded: 
ax = OxOOff; 
break; 

case cmdldleCheck: 
ax = wldleCount; 
wldleCount * 0; 
break; 

case cmdTimerCheck: 
ax » wTimerCount; 
wTimerCount ■ 0; 
break; 

) 

I 

int 

main(void) 

/***********************************★***************** J 

/* — Entry point. */ 

^***************************************************** j 
( 

unsigned far * lpuwllpper; 

unsigned int cpgf, cpgfMax, cbStack; 

unsigned char bVal; 

/* Check to see if we have been loaded already. */ 
_asm 

{ 

mov ax, cmdlsLoaded; 

int 0x2f 

mov bVal, al 

I 

if (bVal == Oxff) 
return 0; 

/* Install TSR. */ 
lpuwUpper = &end; 

cbStack = ((stackavail() + 2048) / 2048) * 2048; 
cpgf = (FP_SEG(1puwUpper) - _psp) + 
(FP_OFF(lpuwUpper) + cbStack) / 16 + 1; 

/* Install interrupt handler. */ 
pfn2f01d = _dos_getvect(0x2f); 

_dos_setvect(0x2f, Int2fHandler); 
pfn2801d = _dos_getvect(0x28); 

_dos_setvect(0x28, Int28Handler); 
pfn0801d = _dos_getvect(0x08); 

_dos_setvect(0x08, Int08Handler); 

_dos_setblock(cpgf, _psp, JcpgfMax); 

_dos_keep(0, cpgf); 
return -1; 

) 

/* End of File */ 
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window itself, or move a facsimile of the window, in fact, this 
is what the SDK’s dialog manager does. It draws the solid out¬ 
line of the control being dragged, and on button up actually 
repositions the window. But the clock applet does use your 
method. The only difference is that the clock is not a child 
window, but a top-level window. 

The reason you won’t see the UM_LBUTTON series of mes¬ 
sages is that the return value from the UM_NCHITTEST mes¬ 
sage tells Windows how to interpret the click. Since a caption 
is part of the non-client area of a window, the child window 
will receive WM_NCLBUTTON messages instead of WM_LBUTTON 
ones. But even if you modify your child window procedure to 
translate the WM_NCLBUTTON messages, you still face a user in¬ 
terface problem. The act of dragging a window involves a but¬ 
ton down, move, and button up. How will you distinguish if 
the user wants to click on the child or drag it? The SDK's 
dialog manager approach is to use a special 'test" mode. 
When in test mode, the user can click on a control to see 
how it behaves, but cannot move it. When not in test mode, 
controls can be dragged, but not clicked. The clock applet 
does not have this problem, since it never responds to clicks, 
only drags (when its caption has been removed). 

One long-standing solution, which probably has just as 
many opponents as proponents, is to use a keyboard key, 
such as the shift, to modify the use of the mouse button. A 
problem with this method is that it forces the user to look 
away from the screen to find a key on the keyboard. Another 
approach might be to use the right button, but this will make 
your user interface nonportable to machines that have one- 
button mice (e.g., the Mac). User interface design is rarely 
easy. 

At any rate, I implemented a demo routine using the shift 
key to enter dragging mode. The program, ChilDrag, displays 
a push button in the middle of the screen. The push button is 
subclassed with the routine LSubClassProc(). When it 
receives a UM_NCHITTEST and the shift key is down (GetKey- 
State(VK_SHIFT) returns a negative value), it returns HTCAP- 
TION. Otherwise, it passes the unaltered message to the 
button’s original window procedure. ChilDrag is implemented 
in childrag.c, childrag.def, childrag.rc, and the makefile 
(Listings 7 through 10). 

Q l’m writing an application that reads data from a file and 
updates a database on disk. The application displays the 
data (stored in DBF format) in different modes (text and 
graphics) on several windows. Reading and displaying data 
“multitask” (a timer is set to a routine that reads and proces¬ 
ses one record, while the data display is updated dynamically 
in windows that can be moved, resized, closed, etc.). 

Now, this kind of "multitasking" works very well until the 
application receives a record that demands heavy operations 
on the database. For example, a particular operation may re¬ 
quire a loop that scans a DBF file and deletes records that 
satisfy a condition. I display a popup window but the user 
cannot abort the operation, cannot switch to another applica¬ 
tion, and cannot exit Windows! 
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• Link libraries into application, or TSRs, or DLLs. 

• C, Assembly. Quickbasic, Visual Basic, Microsoft 
& Borland Windows SDK compatible. 

• Full source for X. Y, & Zmodem file transfer 
libraries, & screen/keyboard libraries. 

• Remote screen management with remote ANSI 
emulation (window scrolling, erasing, etc.). 

• Unlimited number of ports active concurrently. 
Bauds up to 115.2K. Re-entrant code. 

• Asynchronous and timed callbacks to user written 
routines. 

• Real-Time serial port monitor for debugging appli¬ 
cation in real time. 

• 16550A, 16450. 8250 auto detection. 

• Desqview, Procomm DOS/Windows, pcAnywhere 
compatible. 

• Several Windows and MS-DOS examples. 

• One API to learn. All functions behave the same 
under Windows in all modes & MS-DOS. 


Library Sources, Device Driver, TSR S189.95 

Develop Serial Communication 
_ Applications In English _ 

COMM-LOG is a collection of programs & TSRs 
for developing custom applications through our 
simple english like full featured script language. 
These programs may be spawned from user applica¬ 
tion or called via an API. 

• True background X&Ymodem file transfers on 
several ports concurrently. 

• Run several scripts concurrently in the back¬ 
ground, foreground, or from application. 
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MTASK is a robust multitasking kernel for develop¬ 
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When I compile my application with Borland C++ 3.1, l can 
execute any one of these window manipulations, and if I 
switch to other applications, Borland compilation is not 
suspended. 

I've tried to call GetMessagef) during the scan, e.g.: 

while (!eof) { 

OneMessage(); 

ProcessRecord(); 

GoNextRecordQ; 

} 

where procedure OneMessage() is: 

if (GetMessage(...)) { 

TranslateMessage(...); 

DispatchMessage(..; 

} 

Is it safe to follow this approach to solve the problem? What 
do you think about it? 

Now, in this project I have another problem. The data file 
that my application reads and processes is written to by a 
DOS TSR (inherited from the DOS version) that receives data 
from a serial port. This TSR uses INT 28h to flush its memory 
buffer of received data and write it to a file. Under Windows, 
this TSR doesn't work properly, because in some conditions 
INT 28h isn't called frequently enough, and so loses data. Is it 


possible to adjust this TSR (that allows me to receive data 
even if Windows is not loaded)? 

Marco Russo 

Marco.Russo@f108.n334.z2.fidonet.org 

A This problem exists for most nontrivial Windows applica¬ 
tions. The problem with your pseudo-code is that if no 
events are generated for your application, your application will 
block, since GetMessagef) waits until it has a message to 
deliver. 

One solution is to structure your loop as follows: 

while (!eof) 

{ 

MSG msg; 

if (PeekMessage(&msg, NULL, 0, 

0, PMREMOVE)) 

{ 

TranslateMessage(&msg); 

DispatchMessage(&msg); 

} 

else 

{ 

ProcessRecord(); 

GoNextRecord(); 

} 

} 
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PeekMessage(), unlike GetMessagef), always returns immedi¬ 
ately, even if there is no pending input, if it returns true, a 
message was extracted and should be dispatched. Since you 
don't know how long it will take to process the message, or 
how many messages there are to extract, you should extract 
another message if responsiveness is the most important fac¬ 
tor. If PeekMessage() returns FALSE, there is no input for your 
application, making it an ideal time to perform some of the' 
time-consuming work. 

Using this type of loop is not such a good idea in general, 
however. An application that calls PeekMessagef) in a loop 
will never block for input, and becomes a CPU hog with regard 
to well-behaved applications. If Windows is running on a lap¬ 
top, a PeekMessogef) loop will disable power management. 
PeekMessagef) is best suited to time-consuming computa¬ 
tions, where you don’t want to disable user input, but want 
maximum use of the processor. 

To answer the second part of your question I wrote a TSR 
(idletsr.c in Listing 11) that installs an interrupt handler for 
both the idle interrupt (0x28) and the timer interrupt (0x08). 
The TSR also has a multiplex interrupt handler (0x2f) so that it 
can communicate with a Windows application. All the TSR 
does is record the number of interrupts made since the last 
time it was queried for the counts. The multiplex interrupt can 
be made with one of 3 commands: 

• query if the TSR is already installed 

• query the idle interrupt count 

• query the timer interrupt count. 

The values for these commands are defined in Listing 12 
(idletsr.h). I also wrote a Windows program (idle.c in List¬ 
ing 13, idle.h in Listing 14, idle.rc in Listing 15, idle.def in 
Listing 16, and the makefile for both Idle and IdleTsr in List¬ 
ing 17) that presents a dialog that displays the two interrupt 
counts, an “OK” button, and a pair of check boxes. When the 
dialog is created it installs a one-second timer, and each time 
it goes off, the TSR is queried for the two counts. 

The results are interesting. As you would expect, the timer 
count stays steady at around 19 counts per second (the 55- 
msec DOS heartbeat), but the idle interrupt count can vary 
widely. My machine is a 486DX/25. With nothing else running, 
the idle count averaged around 800 per second or so. But if I 
moved the mouse, typed on the keyboard, or opened more 
applications, that number could be seen to drop below 100. 

This is where the check boxes come in. I was curious to 
see what effect not yielding at all —as when you are process¬ 
ing one of your heavy duty updates —would have on the idle 
interrupt frequency. At the end of the dialog procedure, if the 
"Peek loop” check box is checked, a PeekMessagef) loop is 
entered, unless the dialog procedure has already entered one 
(the Boolean fPeeking is used to guard against this). This is 
not a very nice thing to do, since control is not returned to 
the Windows dialog manager until the user unchecks the 
check box. I put in calls to IsDialogMessagef ), Translate- 
Messagef), and DispatchMessage() to keep messages flow¬ 
ing, but this technique is for illustrative purposes onlyl If the 
check box is checked, the idle count drops to 0. Using my 
suggestion of a PeekMessagef) loop for heavy processing 
would not coexist well with your TSRI 
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But there is an oddball interrupt service that can help. The 
multiplex interrupt has a release-time-slice service (function 
0x1680) that non-Windows software uses to signal that it is 
finished with its time slice so that the system doesn't have to 
wait for the time slice to expire. If you check the “Time slice” 
check box, Idle makes the interrupt each time Peek¬ 
Messagef) returns FALSE (when you would do your heavy 
work). On my machine, this causes the idle frequency to ac¬ 
tually hit nearly 2,0001 The DDK warns that a Windows ap¬ 
plication should call WaitMessagef) instead of this function, 
but for your purposes, this is an unacceptable choice. I think 
this warning is meant to prevent the degradation in Windows 
speed that might occur if the interrupt were made frequently 
— particularly since it was designed to be called by non-Win¬ 
dows software to improve the performance of the rest of the 
system. 

Another alternative might be to use the timer interrupt. 
Whether you can or not will depend on the speed of the I/O. 
A third alternative would be to reimplement the I/O portion of 
your application using the SDK's communications routines. 

Q Paul, I have a question regarding virtualisation of com¬ 
munications ports under Windows 3.1 Enhanced mode. I 
am porting a DOS application which communicates with an 
external hardware device — a microcontroller emulator — via 
the serial port to Windows. We use a small in-house written 
assembly library to allow interrupt-driven communications up 
to 115Kb. This library bypasses the BIOS and deals directly 
with the 8250 chip. The library ported to Windows relatively 
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easily (after removing all CODE variables to a DATA segment). 
To allow comparison between running under DOS and Win¬ 
dows, I wrote a simple program using STDIO and the Quick C 
QuickWin library. Running under enhanced-mode Windows 
showed a 25 percent degradation in data transferral times. I 
assume this is entirely due to virtualisation, as running under 
standard-mode Windows gave equivalent performance to run¬ 
ning under DOS. I have the following questions: 

• Can virtualisation of a communications port be turned off? I 
notice it is possible to do this for the timer chip (Trap- 
TimerPorts() in system, ini). As the emulator is “physical¬ 
ly” connected to the serial port there is no question of 
sharing it with anyone else. 

• Does enhanced-mode windows trap/virtualise only certain 
I/O accesses? Can I fool Windows into thinking the COM 
port doesn't exist? 

• Does using the SDK communications calls avoid virtualisa¬ 
tion and can I expect the same speed as my interrupt- 
driven comms in standard mode? 

• Can you recommend any good reading on this subject? My 
library (SDK, Petzold, and Richter) contains nothing. 

A I think your problem is not due to port trapping but to 
the overhead of having the virtual machine manager 
(VMM) and virtual programmable interrupt controller device 
(VPICD) process the 8250's interrupts from the 8259. The first 
time a virtual machine (VM), including the system VM, per¬ 
forms I/O to an unowned COM port, that port will be assigned 
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to the VM, and trapping will be removed for the port. You can 
verify this using the TSS command of either Soft-ICE/W or 
wdeb386. Prior to performing COM1 port I/O, TSS reveals that 
ports 0x3f8 through 0x3fe are trapped, but after some I/O has 
occurred, the ports are no longer trapped. 

COM port I/O in enhanced mode is provided by three key 
components: 

• vcd.386, the virtual communications device 

• combuff. 386, the virtual communications buffer device 

• comm.drv, the bimodal communications driver (a DLL). 

Unlike the system BIOS, which polls the communications ports, 
these three Windows components implement buffered, inter¬ 
rupt-driven, serial-port I/O. They provide additional services to 
help maintain the integrity of serial communications. For ex¬ 
ample, if a DOS session is full-screen and a character is 
received for a Windows application, the character will be buf¬ 
fered and the system VM will be scheduled so that the char¬ 
acter can later be delivered. 

It may be possible to modify the virtual communications 
driver (VCD) using the source code provided with the DDK to 
minimize the time spent in the VMM and VPICD, but this is 
definitely a nontrivial task. You might want to consider using 
the SDK's communications routines. Even though they do not 
avoid the overhead of the interrupt processing inside the VMM 
and VPICD, the coupling between the SDK’s communications 
routines and the enhanced-mode communications com¬ 
ponents is going to be tighter than you can achieve by install¬ 
ing your own interrupt handler. 
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Listing 13 idie.c 


y***************************************************** j 

asm mov w, ax; 

/* Idie.c */ 

/* — Communicate with TSR to detect idle interrupt. */ 

SetDlgItemInt(hwnd, didldle, w, FALSE); 

j*****************************************************j 

_asm mov ax, cmdTimerCheck; 

asm int 0x2f; 

♦include <windows.h> 

asm mov w, ax; 

♦include "idletsr.h" 

SetDlgItemInt(hwnd, didTimer, w, FALSE); 

linclude "idle.h" 

BOOL CALLBACK DlgProc(HWND, UINT, WPARAM, LPARAM); 

) 

break; 

case WM DESTROY: 

♦define wTimerld 1 

int FAR PASCAL 

KillTimer(hwnd, wTimerld); 
break; 

W1nMain(HINSTANCE hins, HINSTANCE hinsPrev, LPSTR lsz, 

case WM COMMAND: 

int wShow) 

switch (wParam) 

y*****************************************************y 

{ 

/* -- Entry point. */ 

default: 

j ***************************************************** j 
{ 

DLGPROC IpfnDlg; 

return FALSE; 

case IDOK: 

BYTE b; 

case IDCANCEL: 
fPeek = FALSE; 

asm mov ax, cmdlsLoaded; 

EndDialog(hwnd, wParam); 

_asm int 0x2f; 

asm mov b, al; 

break; 

if (b != Oxff) 

case didPeek: /* Toggle check box. */ 

{ 

CheckDlgButton(hwnd, didPeek, 

MessageBox(NULL, “IdleTsr has not been loaded.” 

fPeek A = TRUE); 

“ Please exit Windows and run idletsr.exe”, 

“Idle Checker”, MB OK); 

break; 

) 

case didSlice: /* Toggle check box. */ 

else if (IpfnDlg = (DLGPROC)MakeProcInstance( 

CheckDlgButton(hwnd, didSlice, 

(FARPROC)DlgProc, hins)) 

fSlice A = TRUE); 

{ 

break; 

DialogBox(hins, MAKEINTRESOURCE(dlgldle), 

} 

NULL, IpfnDlg); 

break; 

FreeProcInstance((FARPROC)IpfnDlg) ; 
return TRUE; 

} 

) 

return FALSE; 

if (fPeeking) /* Prevent reentrant loop. */ 
return TRUE; 

) 

/* PeekMessageO loop while checkbox is set. */ 
while (fPeeking = fPeek) 

BOOL CALLBACK 

{ 

DlgProc{HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

MSG msg; 

J ***************************************************** j 

if (PeekMessage(&msg, NULL, 0, 0, PM REMOVE)) 

/* — Dialog proc. */ 

{ 

^★★★★★★★★★★★★★★★★★★***'<r****'***************************y 

{ 

static BOOL fPeeking; /* Reentrancy check. */ 

if (msg.message == WM QUIT) 

/ 

fPeek = FALSE; 

static BOOL fPeek; /* Use PeekMessage? */ 

EndDialog(hwnd, FALSE); 

static BOOL fSlice; /* Release slice? */ 

) 

else if (!IsDialogMessage(hwnd, &msg)) 

switch (wm) 

( 

{ 

TranslateMessage(&msg) ; 

default: 

DispatchMessage(&msg) ; 

return FALSE; 

} 

case WM INITDIALOG: 

t 

else if (fSlice) 

( 

if (!SetTimer(hwnd, wTimerld, 1000, NULL)) 

EndDialog(hwnd, FALSE); 

asm mov ax, 0x1680; 

break; 

_asm int 0x28; 

case WM TIMER: /* Get counts from TSR. */ 

{ 

WORD w; 

/ 

} 

return TRUE; 

> 

/* End of File */ 

_asm mov ax, cmdldleCheck; 

_asm int 0x2f; 


March 1993 


Windows/DOS Developer’s Journal — Page 43 





Listing 14 idie.h 


/* idie.h */ 

/* -- Resource file interface for idle checker. */ 

/★★★★★a*********************************************** J 

Idefine dlgldle 1000 /* Idle dialog id. */ 

/* Oialog ids. */ 

#define didldle 1001 /* Idle count static text. */ 

fdefine didTimer 1002 /* Idle count static text. */ 

#define didPeek 1003 /* Peek loop control. */ 

fdefine didSlice 1004 /* Release time slice. */ 

/* End of File */ 


As for reading on this subject, I am sure that there are 
probably one or more books in the works (it seems like the 
growth of books about Windows is greater than the growth of 
Windows itself), but I don't know of anything available now. 
You can find some answers in the DDK, but be prepared to 
read code. What the DDK lacks in documentation it more than 
makes up for in driver source code. □ 
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Listing 15 

idle.rc 




/*****************************************************/ 

/* idle.rc 




*/ 

/* — Idle checker resources. 



*/ 

!***************************************************** j 

linclude <windows 
linclude “idie.h" 

.h> 




dlgldle DIALOG 6, 

18, 126, 38 




STYLE DS M0DALFRAME 1 WS POPUP 1 WS VISIBLE 

1 


WS CAPTION | WS 

SYSMENU 




CAPTION "Timer & 

Idle Tester" 




FONT 8, "MS Sans 
BEGIN 

Serif" 




LTEXT 

"Timers:", -1 

2, 2, 30, 

8 


LTEXT 

“0", didTimer 

36, 2, 40 

8 


LTEXT 

"Idles:", -1, 

2, 12, 30, 

8 


LTEXT 

"0", didldle, 

36, 12, 40 

8 


CHECKBOX 

”&Peek loop", 
2, 26, 52, 10 

didPeek, 



CHECKBOX 

"&Time slice" 

didSlice, 




68, 26, 52, 10 



DEFPUSHBUTTON 

"&0k“, ID0K, 84, 4, 40, 

14 


END 






Listing 16 idie.def 


;; idie.def 

;; -- Linker definition file for idle program. 


NAME Idle 

DESCRIPTION 'DOS Idle Checker' 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 1024 

STACKSIZE 10240 

EXPORTS 

DlgProc @1 


Listing 17 idle.mak— for Idle and IdleTsr 


####################################################### 
## idle.mak ## 

## — Project file for idle catcher. ## 

####################################################### 
all: idle.exe idletsr.exe 

idle.obj: idle.c idletsr.h 

cl -c -AM -G2w -Od -Zipe -W3 -DSTRICT idle.c 

idletsr.exe: idletsr.c idletsr.h 
cl -AS -W3 -Zd idletsr.c 

idle.exe: idle.obj idie.def idle.rc 

link /N0D/m/co idle,,, libw mlibcew, idie.def 
rc idle 
mapsym idle 
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PenRight! Pro SDK 3.1 


Jeffrey L Armbruster 

Vendors and sponsors at the Fall '92 Pen-Expo in Los An¬ 
geles claimed that pen-centric computers will soon eclipse 
notebook and laptop sales combined. Whether this is hype or 
truth, you may soon find yourself looking at pen-program¬ 
ming. You should know up front that all pen-centric software 
is machine specific. PenRight! Pro, PenDos, PenGo, Pen- 
Windows, etc., do not run across platforms. You must choose 
the pen-centric (pen-aware) operating system that runs on the 
specific machine you want to use. You may have to weigh 
which is more important, the machine or the pen develop¬ 
ment software. For example, pen-centric computers with 8086 
or NEC V-20 chips often sustain a battery-life of six to twelve 
hours. 80386 chips last barely four to six hours (they start 
panting after three hours), which is less than a working day 
for most users who need a pen-aware computer. Not all of 
the current Pen-aware software runs on an 8086, which limits 
your options. 

My company selected GRiD's PalmPad, a Nec V-20-based 
computer with a battery life of six to ten hours, because the 
PalmPad is fairly light (less than 2.5 pounds), has no moving 
parts (less likely to break or wear out in the field), and has 
been ruggedized with a strong strap and co-molding around 
the body (it can be dropped onto concrete from a height of 
three feet). In addition, it has removable Flash Memory cards 
for permanent file storage of 5Mb to 10Mb, and Flash Memory 
storage capacity promises to increase to 20Mb or 30Mb by 
next year. The PalmPad met our requirements, and the Pen- 
right Pro! 3.1 Software Development Kit is the only pen-aware 
software that currently runs on the PalmPad. PenDos, Pen- 
Windows, and PenGo do not. 

The PenRight! Pro 3.1 SDK package comes on five disks 
that install easily, and includes five spiral-bound manuals with 
fold-in flaps for saving your place in the manual. A sixth disk 
contains PenRightI runtime. The PenRight! API Reference 
Manual is the programmer's reference on the PenRight! func¬ 
tion library and data structures. The PenRight! Tools User's 
Manual covers the CASE tools, such as PenResource, CodeStart, 
and DesignForm, which make up the PenRightI Pro Software 
Development Kit The PenRight! Application User’s Manual ex¬ 
plains how to use the handwriting features of the software. 
The PenRightI PicturePak Sampler catalogs the clip-art and 


fonts that come with the PenRight! SDK. The PenRight! Learn¬ 
ing Manual walks you through building three examples to help 
you get started writing applications for the GRiDPad. 

PenRightI Pro offers telephone support — you will often 
have to leave a message and wait for a technician to call you 
back. You can also leave questions on PenRight’s BBS, and 
wait until the next day for an answer. 

You need the following items to run PenRightI Pro: 

• VGA screen or AT&T 6300 monochrome-compatible display 

• 3-6 Mb of disk space 

• Microsoft-compatible Mouse 

• Borland or Microsoft C compiler 

• A paint program that can export .pcx files (I have used 
CorelDraw with no problems) 

In addition, if you want to change fonts you'll need a PCX- 
compatible font editor. 

The PenRight! Pro Tools 

All PenRight applications are based on forms. Since there is 
no keyboard, you need to display buttons, lists, fields, dialog 
boxes, and so on, in a format that recognizes pen tapping and 
movements on the screen. You use handwriting recognition 
primarily to retrieve data, and pen tapping for navigation. You 
can also use pen movement with listboxes and you can use 
listboxes as menus. PenRight! Pro’s development tools consist 
of three graphics applications: PenResource, CodeStart, and 
DesignForm. 


Product Information 

Penright! Pro 3.1 
$795.00 

GRiD Systems Corporation 
46501 Landing Parkway 
Fremont, CA 94537 
800-222-4743 


Jeffrey Armbruster works for PIA Merchandising Company in Irvine, California, as a Senior Programmer/Analyst, programming in 
C/C++, Assembly, and Clipper for DOS and MS Windows. He can be reached on CompuServe at 72711,3565. 










PenResource (Figure 1) adds resources such as .pcx bit¬ 
maps, fonts, forms, and code segments to your program. It 
generates a binary resource file that contains the fonts, forms, 
and bitmaps used in your application. The file can be ap¬ 
pended to your executables, or remain as a separate file. In 
short, PenResource assembles the separate pieces of your 
forms, code segments, and bitmaps into a single project file 
which you can save or add to previously built resource files. 

CodeStart (Figure 2) allows you to draw connecting lines 
that graphically display your program’s flow of control be¬ 
tween screens and forms. You can test your program as you 
build it, easily changing the flow or removing and adding 
forms. CodeStart builds a script file from the connecting lines 
you have drawn, then uses the script file to generate the C 


source code and makefile for your project (using a Borland or 
Microsoft compiler). If you choose, you can edit the script file 
directly, or build your own script file and even create your 
own events (code segments or functions), or add C code 
directly to the script file. 

DesignForm (Figure 3) creates and edits the forms used by 
your application. You use it to add lists, check boxes, radio 
buttons, text, bitmaps, and editable fields to your forms. 
Forms can contain fields (with optional pop-up numeric and/or 
character keyboards), buttons, radio-buttons, and listboxes. 
You can have modal or modeless forms. You can specify data 
validation for fields in a form. Figure 4 shows a typical form 
with different types of fields. 

Using the PenRight! Pro SDK 

You can take at least three different 
approaches to developing PenRight! Pro 
programs. One approach is to use the 
CASE development tool to create your 
forms. You then click on a menu and 
PenResource (calling CodeStart) creates 
the C source file and makefile for you. 
One problem with this approach is that 
PenResource writes a line in the 
Microsoft C makefile resource section 
that causes the make to reference it¬ 
self, which produces a make compila¬ 
tion error. Erase the line (every time 
Penrightl sets up the make for you) and 
the error is gone. Another approach is 
to start from scratch using functions 
from the PenRight! Pro library. The third 
option is to combine these two 
development paths, using the CASE tool 
to create your forms and the function 
library to supplement the CASE tool. If 
you want to hook into a database or 
save data collected in a form to a file, 
you must use this third approach. 

To create a form, you draw a form 
using the DesignForm tool. It allows you 
to select buttons, fields, fonts, lists, and 
even other pieces of code. PenResource 
creates an icon for each form or 
resource (code segment) on the screen. 
Then you use CodeStart to draw a line 
between the different forms. When 
your navigation is set, CodeStart creates 
a c source file, a header file of 
# defines , and your makefile. You can 
run and test your event-driven program 
from within CodeStart, without having 
to compile it, or you can exit complete¬ 
ly, compile your program, and run it on 
your coding computer. Your new pro¬ 
gram will accurately recognize hand¬ 
writing with the mouse on your screen. 
When you want to see your program 
on the GRiD, you laplink the program 


Inherit the Benefits 
of Compuware and 
Object-Oriented 
Technologies. 

If you consider yourself a persistent object in search of an 
exciting career opportunity with a company on the leading edge 
of OOPS, talk to an international software and professional 
services leader. Compuware. 

Here's an encapsulation of the incredible benefits you'll 
inherit working with Compuware's 1,700 IS professionals. 

• Work freely within the OS/2 and MS Windows environment 

to construct object-oriented PC products from idea to 
worldwide distribution. 

• Shape the future of peer-to-peer client/server development 
by extending mainframe technology to client/server 
architecture. 

If you have a minimum of 2 years hands-on experience using 
C++, OS2/PM, or MS Windows, software development 
experience, a good understanding of OOPS, and a high band¬ 
width for innovative polymorphic thinking, talk to Compuware 
today at 1-800-292-7432. Or send your resume to: 

Compuware Corporation, Dept. WD, 31440 Northwestern 
Highway, Farmington Hills, Ml 48334 to instantiate an interview. 
Compuware and you. The perfect aggregation. 


COMPUWARE 

AN EQUAL OPPORTUNITY EMPLOYER 
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onto the GRiD (PalmPad uses Interlink 
and Interserver from DOS 5.0) and 
penstrokes will be transformed into 
ASCII characters — with very few errors. 
PenRight! 3.1 cannot be trained to 
handle different handwriting styles; in¬ 
stead, users may have to train themsel¬ 
ves to carefully print letters so that 
PenRight! can recognize their handwrit¬ 
ing. You can also code your program by 
using PenRight! Pro's library, which con¬ 
tains: 


• Control functions: buttons, check¬ 
boxes, and radio buttons 

• Event functions for pen movements 
caused by the user in relation to 
forms, windows, or controls on the 
screen 

• Drawing functions for displaying 
graphics and characters on the 
screen —you can draw pixels, lines, 
solid rectangles, frames, and bit¬ 
mapped images (.pcx file bitmaps) 


Figure 1 PenResource — The PenRight Pro! Project Manager 


- PenResource: (no project) 

File Resources Tools Options Build Help_ 




- PenResource - 


Release: 3.1 
File Date: 07-10-92 

Copyright (C) 1991, 1992 GRiD Systems Corporation 


Figure 2 CodeStart — Flow Control with PenRight Pro! 
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"Sourcer is the best disassembler 
we’ve ever seen." PC Magazine 






Creates commented source code and list¬ 
ings from binary files. Shows how programs 
work with detailed comments on interrupts, 
subfunctions, I/O functions, and more. Sup¬ 
ports all instructions to 80486 and V20/V30. 

Sourcer provides the best analysis separat¬ 
ing code and data. It automatically deter¬ 
mines data types, uses descriptive labels for 
BIOS and PSP data, and links data items 
across multiple segments. 


New version 5.0 makes most DOS EXE and 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 


Top professionals depend on Sourcer for the 
most reliable results with the least effort. 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi PC Magazine 


Windows Source™ with Sourcer generates 
detailed listings of Windows EXEs, DLLs, 
VxDs, device drivers, NT & OS/2 files. Labels, 
by name, export & import function calls, API 
calls like "GetModuleHandle" and more. 


See the many undocumented Windows 
functions used by professionals to perform 
tricks that are otherwise impossible. 

Comes complete with extra utilities for 
resource extraction and import analysis. 
Uses CodeView symbols for improved clarity. 


BIOS Source 


for PS/2, AT, XT, PC and Clones 

The BIOS Pre-Processor™ with Sourcer 
creates commented listings for any BIOS 
ROM in your PC. Understand how your 
specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Identifies 
multiple interrupt branches with special 
labeling like 'int_10_video.' Fully automatic. 


Sourcer-Commenting Disassembler $129.95 
Sourcer w/BIOS -(save $10) 169.95 

ASMtool 486-Automatic flowcharter 199.95 
ASM Checker -Finds source code bugs 99.95 
Windows Source-requires Sourcer 129.95 
Windows Source & Sourcer-(save $30) 229.90 

Shipping: USA $6; Canada/Mexico $10; Other $18. CA 
residents add sales tax. © 1992 VISA/MasterCard/COD 

30-DAY MONEY-BACK GUARANTEE 




1 - 800 - 648-8266 

V Communications, Inc. 


4320 Stevens Creek Blvd., Suite 275-WD 
San Jose, CA 95129 FAX 408-296-4441 
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• Cursor functions 

• Queued Event functions 

• Field functions for handling field events where the user 
enters data by writing characters with the pen on the 
screen. The character is then translated to an ASCII charac¬ 
ter, and displayed in the current font in the field. Field 
functions also handle field validation: i.e., chars, ints, reals, 
etc. 

• Font functions that display fonts on the screen 

• Form functions that create, display, move, and erase forms 
on the screen 


Flandwriting functions supplied with the PenRight! Pro 3.1 
library are low-level functions for translating penstrokes into 
ASCII data. Most of the handwriting input is handled within 
field and form functions, making it unnecessary for you to use 
Handwriting functions directly. Listbox functions resemble the 
form functions, but handle listboxes. Resource functions hand¬ 
le small .exe files, font files, and .pcx files that will be used 
by your application, but stored separately. Window functions 
handle the display and removal of framed and unframed win¬ 
dows. 

What PenRight Pro! 3.1 
Can’t Do 

You cannot hook PenRight! Pro 3.1 
into any other screen library, such as 
Menuet, Vermont View, or escape. In 
order to use one of these libraries, you 
would need their source code so that 
you could then rewrite the mouse func¬ 
tions and tailor them to PenRight Pro! 
Other pen software development 
libraries, such as PenDos, allow you to 
hook into your current text-mode and 
graphics-mode screen libraries with lit¬ 
tle fuss. Also, PenRight Prol 3.1 (graphics 
mode only) does not include a ready- 
built means of hooking a pick-list or a 
listbox into a database file. If your 
database file is larger than memory, 
you will have to code your own scroll¬ 
ing pick-listbox from scratch. Why have 
a library that allows you to make forms 
for collecting data, but doesn't allow 
you to properly show that data to the 
user? 

The PenRight! 3.1 SDK is very easy 
to use, but it has limitations. For ex¬ 
ample, since PenRight! is not designed 
to hook into your existing investment 
of screen libraries, -you must start all 
of your PenRight! user interfaces from 
scratch, if you can live with some of its 
shortcomings, this package has much 
going for it. You can prototype and 
code your pen-aware forms for data 
collection very quickly. The event- 
driven coding procedure used in the 
package allows you to customize the 
code PenResources will produce for 
you. PenRightl Pro is not a mature pro¬ 
gram: it lacks much of the functionality 
in products such as Vermont Views, C- 
Scape, Menuet, and others. If it could 
permit hooks (translation of pen move¬ 
ments to mouse movements), its 
shortcomings would be significantly al¬ 
leviated. □ 


Figure 3 DesignForm - PenRight Pro! Form Management 
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Benchmarking Window 
Instance Data Access 


Ron Burk 


Like most programmers, I have two very bad habits when it comes to program 
efficiency. First, I find it easy to become fascinated by efficiency at a minute level, 
even when rational thought suggests that the area of optimization can have no 
discernable impact on the final product. Second, I find it easy to speculate about the 
efficiency of one approach versus another for hours, without ever making a single 
measurement. 

How do you rate your own knowledge when it comes to efficient Windows 
programming? Do you have a good feel for the relative overhead of various Windows 
API functions? More importantly, can you discern situations where efficiency is of no 
concern at all? 

If you are an experienced Windows programmer, try answering the following 
questions before you continue reading this article: How fast is GetWindowUordf) 
compared to Get Prop () using a string? How fast is GetUindowUordf) compared to 
GetPropO using an atom? How slow are any of these three techniques compared to 
the overall overhead of processing window messages? Compare your answers to the 
measurements I came up with. 

Instance Data Access 

This article started when someone on CompuServe asked if a single callback pro¬ 
cedure could be used to service more than one class of window. Ignoring the ques¬ 
tion of why anyone would want to do this, I suggested using SetPropO to store an 
integer in each window that identified which class of window it was. The single 
callback procedure could retrieve this value with GetPropO and switch on it to 
handle messages differently, depending upon the window class. 

Someone else suggested that this might be too slow and that using properties 
would contribute to the inefficiency. When I thought about this problem later, I 
realized that this is actually an important issue. One of the first decisions you have 
to make in designing a C++ class library or a custom control is how to associate your 
program's data with each Windows window. For example, if you want to create a 
C++ class called Window that corresponds to a Windows window, then you have to 

somehow arrange that when a Windows message ar¬ 
rives, a member function of the class gets called. This 
means that, given the HWND handle to the window, the 
callback function for the window has to be able to 
locate a pointer to the corresponding C++ object. 


=H3s 

Borland C++ V3.1 
Microsoft C/C++ v7.0 


Windows 3.0/3. t 


Ron Burk has a BSEE from the University of Kansas and has been a programmer for 
12 years. He is working on a book tentatively titled WinHelp for Programmers and 
Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, SNA 
98073-3082. CIS: 70302,2566. BIX: rlburk; Internet: ronb@rdpub.com (". . . 

luunetlrdpublronb") 
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Two obvious solutions present themselves: using window 
extra words or using window properties. Window extra words 
are simply extra data in the internal Windows structure as¬ 
sociated with the HUND handle (you have to request the extra 
bytes when you register the class for the window). You can 
set these words with SetWindowWord() and retrieve them 
with GetUindowUord(). Window properties are a means of as¬ 
sociating a two-byte integer with a string for an individual 
window. You store the integer with SetWindowPropO and 
retrieve it by calling GetUindowProp(). 


If you decide to use properties, you have to decide 
whether to associate the property with a string, or with an 
atom associated with a string (as returned by GlobalAdd- 
Atom()). Presumably, the latter approach is more efficient, but 
the SDK documentation provides few clues as to whether or 
not this is the case. 

Does Anyone Measure? 

Most people I talked to had definite opinions about the 
relative efficiencies of these approaches to storing instance 
data, and Microsoft even included a 
whole help topic on this subject in the 
online “Programming Tips" help file that 
comes with the Windows 3.1 SDK. The 
topic is named "Guidelines for Allocating 
Instance (Per-Window) Data,” and it is 
worth noting since it presumably repre¬ 
sents Microsoft's official position on the 
subject. 

In this help topic, Microsoft basically 
recommends that you allocate a word 
of class extra data and use it to store a 
handle to the real data you want to ac¬ 
cess, preferably data in your local heap. 
On the subject of efficiency, the help 
file says "There is a myth that Get- 
WindowWord() and GetWindowLong() 
calls are extremely fast." Microsoft 
recommends using properties in cases 
where you cannot allocate class extra 
data, such as when you are subclassing 
standard child controls. The help file says 
“Using properties is relatively slow.” 

This was all less than helpful for my 
purposes. Phrases like “relatively slow” 
are useless without some indication of 
what the speed is relative to. There was 
a good side to this lack of information, 
however - the thought that perhaps no 
one has ever measured the relative 
speeds of these approaches gave me 
the motivation I needed to do it myself. 

bench.c 

Listing 1 contains the simple Win¬ 
dows program I wrote to provide some 
data by which to compare the relative 
speeds of different approaches to stor¬ 
ing instance data. Calculating processing 
time exactly is difficult, but my goal 
was simply to produce some roughly ac¬ 
curate numbers. The measurements 
begin when you click inside the 
program's main window with the mouse. 

First, I calculate the time necessary 
to execute an empty loop in order to 
subtract that from the other timings. 
Then, for each function call I want to 
measure, I calculate the number of 


Listing 1 bench.c 


♦include <windows.h> 
♦include <stdio.h> 


♦define TIME_STUFF(Stuff, Title)\ 

StartTime - GetTickCountO; \ 
for(i = 0; i < ITERATIONS: ++i) \ 

(Stuff); \ 

StopTime * GetTickCountO; \ 
sprintf(Buffer, "%ld " Title " per millisecond\n", \ 
ITERATIONS/(StopTime-StartTime-LoopTime)); \ 
MessageBox(Window, Buffer, Title, MB_0K); 

♦define ITERATIONS (1000000L) 

void BenchMark(HWND Window, ATOM Atom) 

( 

unsigned long i, StartTime, StopTime, LoopTime; 
char Buffer[256]; 

char *NonAtom * "NonAtom Property"; 


SetProp(Window, NonAtom, 0); 
SetPropfWindow, (LPCSTR)Atom, 0); 


StartTime 
for(i ■ 0; 


■ GetTickCountO; 
i < ITERATIONS; ++i) 


StopTime - GetTickCountO; 

LoopTime = StopTime-StartTime; 

sprintf(Buffer, "%ld loop iterations per millisecond\n", 
ITERATIONS/LoopTime); 

MessageBox(Window, Buffer, "Loop Time", MB_0K); 

TIME_STUFF(GetProp(Window, NonAtom), "GetProp()s“); 
TIME_STUFF(GetProp(Window, (LPCSTR)Atom), “Atomic GetProp()s"); 
TIME STUFF(GetWindowWord(Window, 0)."GetWindowWord()‘s"); 
TIME~STUFF(SendMessage(Window, WMJJSER, 0, 0L),"SendMessage()s"); 
PostMessage(Window, WMJJSER+l, 0, 0L); 

RemoveProp(Window, NonAtom); 

) 


LRESULT CALLBACK WindProc(HWND, UINT, WPARAM, LPARAM); 

int PASCAL WinMain(HINSTANCE Instance, 

HINSTANCE Previous, LPSTR CmdLine, int Command) 

( 

static char AppName[] « "bench"; 

HWND MainWindow; 

WNDCLASS WindowClass; 

MSG Message; 


if(lPrevious) 

( 

WindowClass. 

WindowClass. 

WindowClass. 

WindowClass, 

WindowClass, 

WindowClass, 

WindowClass, 

WindowClass, 

WindowClass, 


style = CS_HREDRAW | CSJREDRAW | CS DBLCLKS; 

lpfnWndProc ■ WindProc; 

cbClsExtra ■ 0; 

cbWndExtra ■ 0; 

hlnstance » Instance; 

hlcon * LoadIcon(NULL, IDI_APPLICATI0N); 

hCursor « LoadCursor(NULL, IDC_ARR0W); 

hbrBackground * GetStockObject(WHITE_BRUSH); 

IpszMenuName » NULL; 
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elapsed milliseconds and then subtract 
the time it takes to execute an empty 
loop that same number of times. 

I wanted to compare the efficiencies 
of these function calls, but I also 
wanted to look at them in the context 
of the user interface. In other words, I 
wanted to know if all the calls are so 
fast compared to normal message 
processing that it really doesn't matter 


which you pick. Therefore, I tried to cal¬ 
culate the overhead in SendMessagef) 
and PostMessagef). 

Benchmarking SendMessage() was 
straightforward. I send a UM_USER mes¬ 
sage in a loop. In the window callback 
function, the message handler simply 
returns zero when it receives a WM_USER 
message. Benchmarking PostMessage() 
was a bit trickier. I send a WM USER+1 


SLATE 5LATLjCR.PT 

with Pf “• & 

Graphics S_PRINT 

Would Text and Graphic 
Printer support for over 850 
printers give you an edge? 

By including SLATE with Graphics, you 
can print Text and Graphics on over 850 
printers. Immediately! Painlessly! 

You can use SLATE in your product 
with no royalties. It gets you out of the 
printer support business. 

Make your product more functional 
and competitive by using SLATE'S 
advanced text features: 

• Output to parallel printers, serial printers, DOS 

files and Novell network printers. 

• Support proportional fonts and scalable fonts. 

• Set exact print positions. 

• Kerning, leading, underlining, and strike through. 

• Automatic character set conversion. 

• Print lines and shaded areas (laser printers only). 

SLATE with Graphics adds advanced 
graphic printing features: 

• Print images from the screen, PCX or TIFF files, 

or custom image systems. 

• Print lines and shaded areas on all printers. 

• Scale and Rotate printed image. 

• Print grey scale and color images. 

• Intermix text and graphics, 

SLATE is a C or Basic library of over 
170 text printing functions, a Database 
of over 850 printers, and End User 
configuration and testing programs. 
SLATE with Graphics adds over 60 
graphic printing functions. 

Would a User Configurable 
Report Writer give you a 
more competitive product? 

SCRIPT is a full featured Text 
Formatting library that can be 
incorporated into your application. 
SCRIPT uses SLATE as its printer 
driver. SCRIPT lets you merge text, 
data, and S_PRINT formatting 
commands from ASCII files and your 
application. 

Enhance your product by taking 
advantage of SCRIPT'S features: 

• Allow users to alter document format. 

• Set exact positions, center, right adjust, and 

decimal align. 

• Fill paragraphs from unformatted text. 

• Add lines, shaded areas, logos, signatures, etc. 

• Add commands and macros. 

Call or FAX now for a complete catalog 
and developer's guide for The 
Symmetry Group's printer support 
products. Order SLATE for $299, 

SLATE with Graphics for $448, or 
SCRIPT for $199 with our risk free, 30 
day return policy. 

The 800-346-3938 

Symmetry P0 Box 26195 

fit-nun Columbus, OH 43226, USA 
vjiuujj gi 4 . 43-1 -2667• FAX614-431-5734 
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Listing 1 continued 


WindowClass.lpszClassName - AppName; 

Regi sterClass(&WindowClass); 

I 

MainWindow = CreateWindow(AppName, AppName, 

WS 0VERLAPPEDWIND0W, 

CW_USEDEFAULT, CW USEDEFAULT, 

150, 150, 

NULL, NULL, Instance, NULL); 

ShowWindow(MainWindow, Command); 

UpdateWf ndow(MainWindow); 
while(GetMessage(&Message, NULL, 0, 0)) 

{ 

TranslateMessage(AMessage); 

DispatchMessage(iMessage); 

) 

return Message.wParam; 

} 

long FAR PASCAL WindProc(HWND Window, 

UINT MsgNum, WPARAM WordParm, LPARAM LongParm) 

( 

switch(MsgNum) 

( 

case WMJJSER : 
return 0; 

case WM USER + 1 : 

I 

static unsigned long StartTime, StopTime, LoopTime; 
char Buffer[256]; 

if(LongParm -* 0) 

StartTime 1 GetTickCount(); 
if(LongParm < ITERATIONS) 

PostMessage(Window, WM_USER+1, 0, LongParm+1); 

else 

{ 

StopTime * GetTickCount(); 

sprintf(Buffer, "%ld PostMessage()s per millisecond\n", 
ITERATIONS/(StopTime-StartTime-LoopTime)); 
MessageBox(Window, Buffer, "PostMessage()s“, MB OK); 

) 

return 0; 

) 

case WM_DESTR0Y: 

PostQuitMessage(O); 
return 0; 

case WM LBUTT0ND0WN: 

( 

ATOM Atom; 

Atom ■ GlobalAddAtomC'AtomName"); 
if(Atom) 

( 

BenchMark(Window, Atom); 

G1obalDeleteAtom(Atom); 

} 

else 

MessageBeep(O); 

I 

default: 

return DefWindowProc(Window, MsgNum, WordParm, LongParm); 

} 

} 

/* End of File */ 
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Table 1 Profiling Instance Data Access Times 


Calls per Millisecond 

Function 

Windows 3.0 

Windows 3.1 

GetPropO 

14 

17 

Atomic GetPropO 

51 

249 

GetWindowWordO 

108 

87 

SendMessageO 

55 

56 

PostMessageO 

5 

6 
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We know 
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full life-cycle of product development. 

At Best Programs in Reston, Virginia 
(suburban Washington, D.C.), we 
deliver what you want. Because we 
know that keeping talented people 
like you happy keeps us a growing 
leader in the development and mar¬ 
keting of packaged, PC-based finan¬ 
cial software. 


As a Windows 
Developer, you’ll use your 
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Microsoft Windows to develop 
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message and the handler increments 
the message parameter and reposts the 
message before returning. 

Table 1 shows the results I obtained 
for Windows 3.0 and Windows 3.1 with 
the benchmark program. These are the 
results I obtained on an 80486 33MHz 
clone running in enhanced mode. 1 
found some of the results surprising. 
Paul Bonneau had mentioned to me 
that GetPropf) is more efficient under 
Windows 3.1, but 1 was still amazed to 
discover that using GetPropO with an 
atom is about five times faster under 
Windows 3.1, and nearly three times 
faster than using GetUindowWord()\ 
Another interesting point is that Get- 
HindowWordO became slower in Win¬ 
dows 3.1, presumably because of addi¬ 
tional parameter checking. 

The speeds of SendMessage() and 
PostMessage() stayed pretty much the 
same between Windows 3.0 and Win¬ 
dows 3.1. SendMessogef) is about as 
fast as calling GetHindowWordf) , but 
PostNessage() is probably more indica¬ 
tive of the overhead of message pass¬ 
ing in the user interface. Under Win¬ 
dows 3.1 you can retrieve an instance 
data handle nearly 40 times in the 
amount of time a “do nothing" message 
handler consumes. 

Summary 

As usual, measuring efficiency 
produced interesting answers. The 
Microsoft admonition that “using 
properties is relatively slow" seems 
highly inaccurate if you only call Set- 
Prop () once to store a data handle and 
you use an atom to retrieve the handle 
when you call GetPropO. In fact, using 
properties to store an instance data 
handle under either version of Windows 
is so fast that the time required is 
dwarfed by the time needed just to pull 
messages out of the queue and call the 
window callback procedure. 

In the big picture, either method of 
accessing instance data is fast enough 
that it matters little which you choose. 
On the other hand, since both methods 
are fairly easy to use, why not use 
properties and free up a few more 
cycles of CPU time for other applica¬ 
tions? In any case, as a result of doing 
this benchmark, 1 will no longer worry 
about window properties being "rela¬ 
tively slow.” D 
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TbxSHIELD 

Bruce Graves 


Toolboxes, button bars, icon palettes, ribbons, speedbars, 
or toolboxes — call them what you will (I’ll refer to them as 
toolboxes in the general sense), users expect them in all but 
the most primitive of today’s Windows applications. The basic 
idea is to provide access to a program’s frequently used com¬ 
mands and options with a single mouse click, rather than 
force the user to repeatedly navigate a series of menus and 
dialogs. 

Originally, toolboxes consisted of a row of buttons that sat 
directly beneath an application’s main menu or that ran verti¬ 
cally along the left side of the program’s primary window 
(users of the original version of MacPaint will remember the 
latter variety with a sense of nostalgia). As time passed, many 
applications added options to customize the individual buttons 
that toolboxes contain. Some included combo-boxes that al¬ 
lowed easy access to frequently changed items like fonts and 
text styles. Still others allowed users to detach the toolbox 
and place it in a movable child window. 

As always, as users’ expectations grew, so did programmer 
workloads. While implementing a specific type of toolbox isn’t 
a major undertaking, creating a generalized toolbox facility 
takes a substantial amount of time and effort. It took me 
roughly a day to implement and refine my own version of a 
simple horizontal toolbox that sits beneath an application’s 


main menu; adding generalized routines to support additional 
types of toolboxes would take considerably longer. 

Why Reinvent the Wheel? 

Toolboxes are a perfect example of a "plug-and-play” com¬ 
ponent, one that can be created and debugged as a stan¬ 
dalone tool and then incorporated into a wide variety of ap¬ 
plications. In this article, I take a close look at the Windows 
version of TbxSHIELD, a toolbox library from The Stirling Group 
designed to give developers easy access to a variety of tool¬ 
boxes without having to create them from scratch. 


Product Information 

TbxSHIELD 

$295.00 

The Stirling Group 
172 Old Mill Drive 
Schaumburg, Illinois 60193 
(708) 307-9197 
(708) 307-9939(BBS) 


Bruce Graves is a freelance writer, programmer, and technical editor, specializing in C++ and windows programming. He has a BS in 
Computer Science from Cornell University. 









TbxSHIELD consists of a series of static libraries and a cor¬ 
responding series of dynamic link libraries (DLLs) for both the 
large and the medium memory models. Depending on the 
language you're writing in and other design considerations, 
you can either link the specific toolbox facilities you need 
directly into your application or distribute the appropriate 
TbxSHIELD DLLs, royalty-free, with your product. 

TbxSHIELD directly supports Borland C++, Microsoft C/C++, 
and Microsoft Visual Basic for Windows. It ran also be used 
with other Windows programming languages, such as Actor 
and Turbo Pascal for Windows, that support DLLs and either 
direct callback functions or message-oriented callbacks. Later 
in the article I discuss in detail the callback options and how 
TbxSHIELD uses them to communicate with your application. 

TbxSHIELD is distributed on a single high-density disk in 
both 3.5" and 5.25" formats. The manual comes in a standard 
three-ring binder and is adequate in most respects, though 
the faded figures, slightly blurred text, and occasional spelling 
and grammatical errors can be annoying. The main body con¬ 
sists of three sections, which introduce the basic ideas behind 
TbxSHIELD, give an overview of the various types of toolbox 
controls and how to use them, and provide a reference to all 
the functions that make up the TbxSHIELD API. Several appen¬ 
dices address a variety of topics, including frequently asked 


questions and how to contact The Stirling Group if you need 
assistance. 

Toolbox Types 

TbxSHIELD supports standard horizontal and vertical button 
bars like those found in many applications. Individual buttons 
ran be packed together with no space in between or grouped 
logically by function. Because the window that contains the 
buttons is a regular child window, you can also add other 
controls, such as combo-boxes or edit windows, by railing 
standard Windows functions. This technique allows you to 
create a toolbox that mimics the hybrid button bars found in 
Microsoft Word and many other applications (see Figure 1). 

In addition to button bars that stay in one spot and con¬ 
tain a single row of controls, TbxSHIELD supports what it calls 
icon palettes, or child windows that contain a rectangular 
array of buttons and ran be moved anywhere within their 
parent window. Though the windows themselves are fixed in 
size, you can add horizontal and vertical scrollbars to provide 
access to a large array of buttons without taking up too much 
of the screen. Scroll buttons, an alternative to scroll bars, pro¬ 
vide the same functionality but take up less space within the 
icon palette itself (again, see Figure 1). 

TbxSHIELD’s most innovative feature is a toolcube, a simu¬ 
lated three-dimensional control that has a rectangular array of 


Figure 1 Examples of toolboxes created with TbxSHIELD 



=> Scroll Bar ▼ 

H*/ 

? 21 

o 

jfr 

13 

1*1 

i J 

J §2 

s 

iL 

i+ 



Doas 


Bears 

Cats 


Dogs 


Humans 




Page 54 - Windows/DOS Developer’s Journal 


March 1993 





































































































































buttons on all sides. By clicking on one of the arrows in the 
upper corners of the cube’s title bar, the user can rotate the 
cube to display the side that contains whichever buttons he 
or she needs. Like toolboxes with scroll bars, toolcubes let you 
access more buttons than would otherwise fit in a given 
amount of screen space. Note that the terms “most innova¬ 
tive” and "most useful” aren't necessarily one and the same 
when discussing interface features: toolcubes are interesting 
to look at, but an ordinary toolbar is often just as useful. 

Buttons in TbxSHIELD toolboxes can contain standard bit¬ 
map images that appear to depress when the button is 
pushed, images that toggle back and forth, or even variable- 
speed animation sequences. Like toolcubes, animated buttons 
are interesting for a time, but they would drive most users 
crazy if you incorporated them into a standard button bar. 
Buttons in an About . . . dialog box, on the other hand, are 
prime candidates for eye-catching animation. TbxSHIELD also 
supports a drag-and-drop feature, which allows users to trans¬ 
fer buttons between toolboxes by simply clicking on a button 
in one and dragging the image to another, of course, each 
toolbox must be specifically designed to supply or receive 
buttons. A typical application might allow users to customize 
its default toolbox by displaying a master icon palette upon 
request and letting users drag icons back and forth between 
the two controls until the buttons they use most frequently 
are within easy reach. 

Adding Toolboxes 

The processes for including TbxSHIELD toolboxes in an ap¬ 
plication from the beginning or incorporating them into an ex¬ 
isting program are equally straightforward and are very similar 
to adding standard menus. First, you use a paint program to 
create the individual button’s bitmaps and store the images as 
.bmp files that will be incorporated into the program’s resour¬ 
ces. Next, you write the code that creates, manages, and 
destroys the toolbox itself. At this point, it’s easy to test the 
program to see if the toolbox appears properly and behaves 
as expected. Finally, you add the functions that respond to 
specific toolbox events. This usually consists of a simple trans¬ 
lation layer that calls the same functions that would be in¬ 
voked by corresponding menu selections. 

Once you’ve added one or more toolboxes to your pro¬ 
gram, the TbxSHIELD API allows you to manipulate them at a 
fairly high level through a wide variety of API functions. For 
example, you can hide or show a toolbox, move it, specify the 
colors used for various components, and so forth, without 
ever calling the Windows API directly. The TbxSHIELD API also 
lets you manipulate individual toolbox buttons; you can 
modify button data or selection states at any time with 
straightforward function calls. If the API does not support what 
you are trying to achieve, you can also obtain the Windows 
handle to toolboxes or specific buttons and manipulate them 
directly via the Windows API. As mentioned earlier, this is how 
you would add features such as combo-boxes to an existing 
toolbar. 

Callback Methods 

TbxSHIELD supports three separate callback methods that a 
toolbox or its individual components can use to notify your 
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Listing 1 tbx.cpp 


linclude <owl.h> 

// Turn on C++ conventions in the header file 
#define _C0MPILER 3 
#include <tbx.h> 

// 

// A window class 

// 

class TBoxWin : public TWindow 

f 

public: 

TBoxWin(PTWindowsObject pParent, LPSTR psTitle) 
:TWindow(pParent, psTitle) { } 


// 

// These are static because they're callback functions. 

// 

static BOOL PASCAL 

DefToolboxProc(PTBXOBJECT pTbx, int nButtonID); 
static BOOL PASCAL 

FlatButtonProc(PTBXOBJECT pTbx, int nButtonID); 

protected: 

// Button ids: 

enum ( eButSmile = 100, eButFlat = 101, eButFrown = 102 }; 

// Our toolbox: 

PTBXOBJECT pTbx; 

// Called after successful window creation, 
virtual void SetupWindowQ; 

// Called when a WM_CL0SE message is received. 

virtual void WMClose^RTMessage msg) = [WM_FIRST + WM_CL0SE]; 


// 

// An application class 

// 

class TBoxApp : public TApplication 

f 

public: 

TBoxApp(LPSTR psName, HINSTANCE hlnst, 

HINSTANCE hPrevInst, LPSTR psCmdLine, int nCmdShow) 
:TApplication(psName, hlnst, hPrevInst, 
psCmdLine, nCmdShow) { ) 

virtual void InitMainWindow() 

{ MainWindow = new TBoxWin(NULL, "Toolboxes!"); ) 

1; 


// 

// OWL function called once a TBoxWin window has been created. 
// Create the toolbox, a child window. 

// 

void TBoxWin::SetupWindow() 

( 

// Base class processing first. 

TWindow::SetupWindow(); 

HINSTANCE hlnst = GetModule()->hInstance; 


// Create the toolbox 
pTbx = 

TbxCreate(hInst, 

HWindow, 

"A Toolbox!", 

(PFN)DefToolboxProc, 
NULL, 

3, 

TBX_CAPTION); 


// application instance 
// parent window 
// caption 

// default event function 
// private data 
// number of columns 
// style 


application of an event such as a but¬ 
ton press or a scrolling action. The 
standard callback method consists of a 
direct call to a function whose address 
you supply when you create a control. 
For example, if you have the following 
function in your program: 

Idefine ID_BUTT0N1 200 
#define IDBUTT0N2 201 

BOOL PASCAL FAR 

DefCal1 back(PTBXOBJECT pTbx, int nID) 

{ 

switch(nlD) { 
case ID_BUTT0N1: 

break; 

case ID_BUTT0N2: 
break; 

} 

} 

you can create a toolbox that will call 
DefCallback() whenever a toolbox 
event occurs with code like this: 

pfnDefCallback = 
MakeProcInstance(DefCal 1 back); 

PTBXOBJECT pTbx; 
pTbx = TbxCreate(hInstance, 
hwndParent, 
pszCaption, 
pfnDefCallback, 
pCustomData, 
usColumns, 
ulStyle); 

where hlnstance is the instance of the 
current application, hwndParent is the 
handle of the toolbox’s parent window, 
pszCaption is the toolbox’s caption, 
pfnDefCallback is a pointer to the 
callback procedure for this toolbox, p- 
CustomData is a pointer to any data 
that you want to associate with this 
toolbox, usColumns is the number of 
columns that this toolbox will have, and 
ulStyle indicates which type of tool¬ 
box you want to create. (Note that if 
you’re using Borland C++ or Microsoft 
C/C++ 7.0 with smart callbacks enabled, 
there’s no need to deal with procedure 
instances; you can pass the address of 
DefCallback() directly when you cre¬ 
ate the toolbox.) 
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Some languages, such as Actor, don’t 
support direct callback functions, so 
TbxSHIELD also supports callbacks 
through Windows messages sent to a 
toolbox's parent window. To use the 
message callback mechanism, you cre¬ 
ate a toolbox the same way you would 
for direct callbacks except that you pass 
NULL instead of a pointer to a callback 
function. Then you call TbxOwner- 
Uindow() to register a window where 
toolbox event messages should be sent. 
For example.- 

TbxOwnerWindow(pTbx, 
TBX_OWNER_STANDARD, 
hwndMessages); 

where pTbx is a pointer to the toolbox 
that you just created, 
TBX_OUNER_STANDARD indicates that you 
want standard messages (as opposed to 
Visual Basic messages, discussed later) 
sent in response to toolbox events, and 
hwndMessages is the handle of the win¬ 
dow to which the toolbox should send 
event messages. The event messages 
themselves are just standard m_C0M- 
MAND messages with message identifiers 


Listing 1 continued 


II Set button size 
TbxButtonSize(pTbx, 40, 40); 

// No space between buttons 
TbxFreeArea(pTbx, 0); 

// 

// Add some buttons. 

// Only the 2nd one has its own event function; 

// the others will use the toolbox's default. 

// 

TbxCreateButton(pTbx, // the toolbox 

eButSmile, // button id 

(PFN)NULL, // event function 

TBX_BUT_SBITMAP, // named bitmap style 

(UL0NG)“bmpSmile"); // bitmap name 

TbxCreateButton(pTbx, 

eButFlat, 

(PFN)FlatButtonProc, // special! 
TBX_BUT_SBITMAP, 

(ULONG)“bmpFlat"); 

TbxCreateButton(pTbx, 

eButFrown, 

(PFN)NULL, 

TBX_BUT_SBITMAP, 

(ULONG)“bmpFrown"); 

// Move the toolbox to (100,100) screen coordinates. 
TbxMove(pTbx, 100, 100); 
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Listing 1 continued 


II Let it know we're done with construction. 
TbxComplete(pTbx); 

// Show it onscreen. 

TbxShow(pTbx, TRUE ); 


// 

// The default toolbox event function. 

// Called for the smile and frown buttons. 

// 

BOOL PASCAL 

TBoxWin::DefToolboxProc(PTBXOBJECT pTbx, int nButtonID) 

{ 

switch(nButtonlD) { 
case eButSmile: 

MessageBox(NULL, “Smile! 11 , "Button", MB_0K); 
break; 

case eButFrown: 

MessageBox(NULL, "Frown!", "Button", MB_0K); 
break; 

} 

return TRUE; 

} 

// 

// The flat button's event notification function. 

// 

BOOL PASCAL 

TBoxWin::FlatButtonProc(PTBXOBJECT pTbx, int nButtonID) 
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set to constants defined in the 
TbxSHIELD header files. 

Finally, if you're using Visual Basic for 
Windows, you follow a procedure 
similar to the previous one. The only 
difference is that you use the 
TBX_OMNER_VBASIC style (instead of 
TBX_ONNER_STANDARD) when you call 
TbxOwnerUi ndow(). Then, when toolbox 
events occur, your form’s KeyDown pro¬ 
cedure will be called and you can use a 
series of TbxSHIELD API functions to 
determine which toolbox control was 
actually manipulated and what the 
event was. 

Adding Buttons 

Once you've created the toolbox it¬ 
self, the next step is to create and add 
the individual buttons. For example: 

TbxCreateButtonfpTbx, 

nButtonID, 

NULL, 
usStyle, 
ulStylelnfo); 

creates a button, where pTbx is a 
pointer to the toolbox to add the but¬ 
ton to, nButtonID identifies the button, 
NULL indicates that you want the 
default toolbox callback function to be 
called for any button events, usStyle 
indicates what type of button this is, 
and ulStylelnfo provides information 
that depends on the style. 

As an alternative to routing event 
notification through the toolbox's 
default callback function, you can supp¬ 
ly a pointer to a unique callback func¬ 
tion for each button. This can be useful 
because it allows you to avoid switch 
statements like the one illustrated in 
DefCal lback(). On the other hand, if 
the only action required in response to 
a button event is a call to the same 
function that a menu event triggers, the 
switch statement can be more concise. 

A button's style determines how it is 
drawn. In the simplest case, usStyle 
would be TBX_BUT_SBITMAP and ul¬ 
Stylelnfo would be a pointer to a 
string that identifies the bitmap 
resource associated with this button. 
You can also specify types that use 
owner-draw procedures, animation 
callback functions, handles to bitmaps 
or icons, or even .bmp files to draw the 
button. When your program is ready to 
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terminate, you would delete the tool¬ 
box and free its callback procedure in¬ 
stance with 

TbxDestroy(pTbx); 
FreeProcInstance(pfnDefCal1 back); 

This also destroys the buttons inside 
the toolbox. 

An Example 

Listing 1 ( tbx.cpp ) presents a com¬ 
plete C++ program, based on Borland's 
ObjectWindows Library, that 
demonstrates how little code is re¬ 
quired to incorporate a TbxSHIELD tool¬ 
box into an application. When the pro¬ 
gram is executed, it creates a standard 
application window, which in turn 
creates a simple toolbox that contains 
three buttons —a smile, a frown, and a 
flat-face — whose bitmaps are included 
in the program’s resource file (see Fig¬ 
ure 2). In this program, you can drag 
the toolbox anywhere on the desktop, 
though a style that clips the toolbox to 
its parent’s client area could be used in¬ 
stead. 


Listing 1 continued 


MessageBox(NULL, "Blah!", “Button", MB_0K); 

} 

// 

// Before the window closes, destroy the toolbox. 

// 

void TBoxWin::WMClose(RTMessage msg) 

{ 

// Toolbox destruction. 

TbxDestroy(pTbx); 

pTbx = NULL; // safety! 

// Base class processing. 

TWindow::WMClose(msg); 


// 

// Create and run the application 

// 

int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR lpCmdLine, int nCmdShow) 

{ 

TBoxApp BoxAppC'BoxApp", hlnst, hPrevInst, 
lpCmdLine, nCmdShow); 

BoxApp.Run(); 
return BoxApp.Status; 


// End of File 
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Because neither the smile nor the frown buttons have their 
own callback functions, their events are routed through the 
toolbox's routine, TBoxUin::DefToolboxProc(), and processed 
via a switch statement. The flat-face does have its own 
callback function, TBoxUin::FlatButtonProc (), so no switch 
is necessary. In any case, pressing a button displays a mes¬ 
sage box that indicates which one you selected, when the 
program's window receives a UM_CL0SE message, it first 
destroys its toolbox and then allows default message process¬ 
ing. 

Conclusion 

There are several areas in which TbxSHIELD could be im¬ 
proved. First, I was hoping for a set of C++ classes to encapsu¬ 
late the various types of toolboxes and to insulate the 
programmer from the underlying API calls-, unfortunately, none 
are included. Also, while the documentation is adequate, I ex¬ 
pected better writing and a higher-quality format, given the 
product's suggested retail price of $295. Several topics, such as 
how to use TbxSHIELD with C++ and exactly which switches 
need to be set for various compilers and linkers (and why) are 
not discussed. While the supplied examples are helpful in 
these areas, they should be covered more thoroughly in the 
manual itself. 


In my eyes, however, the product’s biggest drawback is 
that it does not include source code (the complete source 
code for TbxSHIELD costs between $1900 and $3900 — out of 
reach for many developers). As a developer, I want to see 
what's going on behind the scenes before I incorporate a 
third-party product into a real application. It is not uncommon 
to encounter ambiguities when only high-level documentation 
is available, and access to source code can save a lot of time 
and effort that would otherwise be spent experimenting with 
the product or talking with a company’s technical support 
department. Both Borland and Microsoft clearly acknowledge 
the importance of source code-, they provide it with both the 
ObjectWindows and Microsoft Foundation Class Libraries, 
respectively. 

Note that none of these issues is directly related to perfor¬ 
mance. Overall, TbxSHIELD is a solid product that, for many 
projects, is well worth using. Features like drag-and-drop and 
scrollable toolboxes can add a polished look-and-feel to a pro¬ 
gram and help set it apart from some of its competitors. If 
these interface elements had to be coded from scratch, the 
time and effort might be prohibitive for small or medium-sized 
applications. With TbxSHIELD, however, enhancing a program's 
interface only requires a little extra work. As users' expecta¬ 
tions rise, you can't afford not to explore libraries like this one. □ 
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formation in the mail from 
these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 


Windows/DOS 

□ DEVELOPER'S JOURNAL 

1601 W. 23rd. St., Suite 200 
Lawrence, KS 66046-2 7 43 


Figure 2 Windows created by the program in Listing 1 




A Toolbox! 

* ♦ 

♦ ♦ 

♦ ♦ 
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■ Tech Tips 

Reader-Contributed Tricks and Hacks 



Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks - those 
clever pieces of code to 
make things work the 
way they should! You’ll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


Un-Redirection, 

Screen Savers, 

and Bulletproofing Windows 


Suppressing I/O Redirection for Child Processes 


Fred Smith 
20 Whipple St. 
Stoneham, MA 02180 


A few years ago I wrote my own clone of the UNIX program wore, since there 
were no decent ones available for the microcomputer I was using at the time. Later I 
ported it to MS-DOS, where additional features were available in the OS. One of those 
additional features was I/O redirection, similar to that in UNIX. 

It didn’t take long after I distributed my version of more (via Usenet) for someone 
to point out to me that when more was reading its input from a redirected input 
stream and a shell escape had been used from within more, the input stream for the 
shelled program was still the redirected input of more. 

At that time I was unable to find any significant literature on —or for that matter, 
anyone who knew much about — how to fix this problem. So, it was with a copy of 
Ray Duncan's Advanced MSDOS and a couple of evenings of my time that I ap¬ 
proached the problem. 



Leor Zolman wrote BDS C, the first C compiler targeted exclusively for personal com¬ 
puters. Leor is currently an instructor on UNIX topics for Boston University's Corporate 
Education Center, a regular contributor to The C Users Journal and Sys Admin 
magazines, and “Tech Tips" editor for Windows/DOS Developer's Journal. His first book, 
Illustrated C, was recently published by R&D Publications, Inc. He may be contacted 
at 74 Marblehead St., North Reading, MA 01864, or on Usenet/Internet as: 
leor@bdsoft.com. 
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applications 
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Illustrated C 

by 
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Discover the WHY and 
HOW of application design 
and development in C. 
Explore the construction of 
several different applications 
from start to finish. Chapter 
after chapter you’ll develop 
your skills through in-depth 
tutorial and detailed code. 



( $ 39 ~ with disk) 


CALL TODAY! 

913 - 841-1631 

FAX 913-841-2624 

rrm ^astcrCard 


publications, inc. 


Listing 1 demo.c 


/* 

* DEMO.C 

* Written by Fred Smith 

* Developed with MSC 5.1 

* 

* Tested under Borland C++ 3.1 (by LZ) 

* Compile with -DTEST compiler switch. 

* Borland C++: 

* bcc -DTEST demo.c 
*/ 

linclude <stdio.h> 

#include <string.h> 
linclude <stdlib.h> 
linclude <process.h> 
linclude <fcntl.h> 
linclude <io.h> 


* Calls spawnlpO to execute the command which is passed in 'string'. 

* 

* Checks the specified stream to see if it has been redirected 

* and if necessary will un-redirect it before the child program is 

* executed, then re-redirect it after the child returns. 

*/ 

FILE * do_cmd(FILE ‘stream, char * string) 

{ 

char shell_name [128 + 1]; 
char * envptr; 

char get_switch_char (void); 
int old, redirected = 0; 
int new; 

/* find out which command processor to use */ 
envptr = getenv ("COMSPEC"); 
if (envptr != (char *) 0) 

strcpy (shell_name, getenv (“COMSPEC 1 ')); 

else 

strcpy (shell_name, “command.com"); 

/* if input is redirected, restore stdin to the console */ 
if (stream — stdin) 

{ 

old = dup (fileno (stdin)); 
new = open (“CON", 0_RD0NLY); 
dup2 (new, fileno (stdin)); 
redirected - 1; 

) 

/* fire off the child process */ 

if (strlen(string) != 0) /* do single command */ 

{ 

spawnlp (P_WAIT, shelljiame, shelljiame, 

“/c“, string, (char *)NULL); 

) 

else /* give me a command prompt */ 

{ 

spawnlp (P_WAIT, shelljiame, shelljiame, (char *)NULL); 

) 


/* if needed, reinstate the original redirection */ 
if (redirected) 

{ 

dup2 (old, fileno (stdin)); 
close (new); 

) 

return (stream); 
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Listing 1 continued 


} 

lifdef TEST 
main () 

{ 

if (do_cmd(stdin, “junk.exe JUNK.FIL") !• stdin) 
fprintf (stderr, “Redirection fai1ed!\n"); 

return (0); 

} 

#endif /* TEST */ 

/* End of File */ 


Although the fix is relatively simple, I 
have seen in the intervening years 
questions from several other program¬ 
mers about how to work around this 
situation. Apparently there still isn't 
much literature on it. 

Listing 1 shows do_command(), a 
simplified version of the C function I 
developed to allow my more clone to 
un-redirect its input stream before 
spawning a child program. The program 
needs to determine if its input stream 
has been redirected, in the main pro¬ 
gram, the following logic is used: 

FILE * stream; 
if (argc < 2) 

stream = stdin; 

else 

stream = fopen (...); 

Subsequently, if the user wants to do a shell escape, do_com- 
mand() is called and handed the current input stream, and a 
command to execute. Here is the part of do_cotmand() that 
takes care of un-redirecting the input before the child process 
is spawned: 


if (stream == stdin) 

{ 

old = dup (fileno (stdin)); 
new = open ("CON", 0_RD0NLY); 
dup2 (new, fileno (stdin)); 
redirected = 1; 

} 

First, if stream is not the standard input, then the input is a 
normal file, not a redirected stream (because of the excerpt 
shown a couple of paragraphs earlier). 

If stream is equal to standard input, then redirection is in 
effect and must be undone. This is accomplished in steps. 
First, I use the dup() library function (equivalent to MSDOS INT 


MS dos System 
Programming 

2nd Edition 


Edited by Robert Ward 
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0x21, Function 0x45) to obtain a duplicate handle for the 
current input stream. This is an integer value, as if returned 
from an open() call. This value must be saved so that after 
the child process returns, the program's input can be recon¬ 
nected to the correct file. 

The second step is to open in read mode the device to 
which standard input would have been connected had it not 
been redirected (in this case "CON," or the PC's console). The 
third step is to use the dup2() library function (equivalent to 
MSDOS I NT 0x21, Function 0x46) to force the standard input 
stream to point to the new file just opened. This call discon¬ 
nects stdin from the redirected input file and connects it to 
the newly opened console. From this point on, if you read 
from standard input, the input will come from the PC’s key¬ 
board (its console). The last step is to set a flag to indicate 
that the redirection has been changed. 


Later, after the child process has returned, the program has 
to determine if redirection had been disconnected, and if so, 
put it back the way it was. The following excerpt from 
do_comand() handles this step: 

if (redirected) 


dup2 (old, fileno (stdin)); 
close (new); 


) 


Listing 3 ssaver.c 


II . 

// SSAVER.C 

// Written by Scott A. Mintz 
// 

// Compiler (Borland C++ 3.1): 
// bcc -W saver.c 
//. 


#include <windows.h> 

#ifndef SPI_GETSCREENSAVEACTIVE 

#error This program requires the Windows(tm) 3.1 header file 
lendif 


int PASCAL WinMain( 

HINSTANCE hlnstance, 

HINSTANCE hPrevInstance, 

LPSTR lpCmdLine, 

int nCmdShow ) 

{ 

char szSSName[128]; 

BOOL bSSActive; 

(void)hlnstance; // avoid unused args warnings 

(void)hPrevInstance; 

(void)lpCmdLine; 

(void)nCmdShow; 

SystemParametersInfo( SPI_GETSCREENSAVEACTIVE, 

0, &bSSActive, FALSE ); 

if( bSSActive SS 

GetPrivateProfileString( "boot", 

"SCRNSAVE.EXE", 

II II 

szSSName, 

sizeof( szSSName ), 

"SYSTEM.INI" ) ) 

( 

lstrcat{ szSSName, " -s" ); 

WinExecf szSSName, SW_SH0W ); 

} 

else 

MessageBox( NULL, "There is no screen saver is installed.", 
"Information", MB_0K | MB_IC0NINFORMATION ); 

return 0; 


This is a simpler operation, involving only two steps. Since the 
first part of the code sets a flag when it un-redirects the 
standard input, you know that the redirection must be res¬ 
tored. The first step is to (again) call dup2(), this time forcing 
the stream stdin to point to the file whose handle was 
stored above. This causes stdin to be dis¬ 
connected from the console and recon¬ 
nected to its original input source. Sub¬ 
sequent input would then come from 
the redirected source, not from the PC's 
console. The final step is to close the 
file that opened earlier for the console. 

Listing 2 is a simple application that 
illustrates the process. To test this 
functonality, compile demo.c in Listing 1 
(defining TEST as shown in the program 
comments), then compile junk.c (List¬ 
ing 2) and run the demo program with 
its input redirected from some text file. 
If the redirection is properly turned off, 
everything you type should end up in 
the file junk.fil. If redirection is not 
properly turned off, something else will 
happen — most likely, the contents of 
the file you redirected into the demo 
program will end up there. To terminate 
the program, type *z<cr>, i.e., Control- 
Z followed by the RETURN key. The sys¬ 
tem will then return to the demo pro¬ 
gram, which will reinstate the redirec¬ 
tion before exiting. 


) 

/* End of File *1 


A Hot-Key 
for the Standard 
Windows Screen Saver 


Scott A. Mintz 
34208 Aurora Road, Suite 294 
Solon OH 44139-3803 
CIS 71461,632 


The screen saver that comes with 
MS Windows 3.1 is great but can't be 
invoked by a hot-key combination. 
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I tend to get bored with things after 
a while so i change my screen saver 
often. I wrote a really simple program 
(ssaver.c, Listing 3) which can be 
added to a PROGMAN group and as¬ 
signed a hot-key that will start the cur¬ 
rently installed screen saver. It uses a 
new Windows 3.1 API call System- 
Parameter sin fo() to determine if there 
is an active screen saver installed. Then 
it reads the SCRNSAVE.EXE value from 
the “boot" section of SYSTEM. INI to 
determine the program name of the ac¬ 
tive screen saver. 




Converting a Windows 
Screen Saver 
into an Application 


James K. Lawless 
1622 Ave F 
Council Bluffs, IA 


* JUNK.C 

* Written by Fred Smith 

* 

* Sample application which reads from stdin and writes to the 

* file named as the first comnand-line parameter. 

* 

* Compile: 

* bcc junk.c 


#include <stdio.h> 
linclude <stdlib.h> 


main 

{ 


(int argc, char ** argv) 
junk; 


FILE 


if ((junk = fopen (argv[1], V')) »■ (FILE *)0) 
exit (0); 

while (feof (stdin) ■« 0) 

( 

fputc (fgetc (stdin), junk); 

) 

fclose (junk); 
return 0; 


} 

/* End of File */ 


After a friend asked me if I knew the 
"trick" to getting Windows screen-saver 
programs to run as though they were normal applications, my 
curiosity got the best of me and I discovered a few things. My 
friend told me that he had already tried to run a screen saver 
by copying a .SCR file to an .EXE file and adding the item to 
a Program Manager group. Double-clicking on the icon caused 
it to invoke the screen saver’s configuration dialog, but did not 
invoke the screen saver itself. 

To determine how the screen saver normally works, I used 
Soft-lce/W to place a breakpoint on INT 21h function 4Bh 
(load and execute a program). Then I set up a screen saver to 
execute after one minute of inactivity. After one minute, Soft- 
lce/W activated, letting me know that the interrupt I trapped 
had been activated. Dumping the values in DS-.DX illustrated 
that Windows was trying to invoke the screen saver with a 
command-line parameter of "Is". I copied the screen saver to 
an .EXE file and added it as a Program Manager icon with a 
parameter of "Is". Voilal The screen saver popped up. 

This technique would cause an awful waste of space if you 
had to copy all of your screen savers to . EXE files. I found 
that if you simply change the "Programs=“ entry in the 
"[windows]" section of your MIN.INI file from the normal 
"com exe bat pif" to “com exe bat pif scr" you can run 
the screen saver without renaming it (but remember to in¬ 
clude Is in the Properties command line). 



GR0UPWNDPR0T! 

GR0UPWNDPR0C918^B 
GR0UPWNDPR0C91883 
GetClientRect(1884,WIVLPAl 
GetTextMetrics(IFFAO) = 1 
SetTextColor(O) = 0 
Text0ut(C3A,25.251 ,"lan Remington",10) =T 


emington 

'rand Opening’93 


} 1 Ln 2.75" Pos 1.56" 
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Bulletproofing MS Windows Routines 


Moshe Rubin 
Triton Software Ltd. 
115a Manhat 
Jerusalem 96900 
Israel 

Practically every Windows developer has experienced “Un¬ 
recoverable Application Errors" (UAEs) during program develop¬ 
ment Common reasons for UAEs are invalid parameters, hand¬ 
les, pointers, and "dangling” memory pointers, to mention 
some of the main culprits. 


Windows applications can be made more stable by "bul¬ 
letproofing" internal routines. The template for routines shown 
in Listing 4 can provide the necessary stability, bypassing 
many UAE-causing pitfalls. 

A few comments regarding the template: 

1. Define a return value variable (e.g. Ret) of the same type 
as returned by the routine, initializing it to a value denoting 
“failure.” For example, an LPSTR should be initialized to NULL, 
a BOOL to FALSE, etc. If the routine finishes successfully, set 
the return value variable to a non-"failure” value. 

If the routine returns a VOID, use a local BOOL variable 
denoting the occurrence of an error. 

2. An error encountered at any point in the routine should 
cause a branch to the exit: label. At exit:, check the return 
value variable. If it is still set to its initial “failure,” undo 
memory operations. In this way, dangling memory allocations 

are cleaned up before leaving the 
routine. 

3. Define HANDLE and pointer vari¬ 
ables for memory allocations, initializing 
them to NULL. This will enable the 
routine to undo any memory alloca¬ 
tions and lockings, if necessary. 

4. Validate parameters by verifying 
that string pointers are non-NULL, that 
HWNDs denote valid windows (using 7s- 
UindowO), and that other user-defined 
parameters pass validity checks. Editor's 
note: Windows 3.1 gives you several 
functions for more detailed pointer 
validation. Check out IsBadCodePrt(), 
IsBadReadPtr(), IsBadUritePtr(), etc. 

The goto exit statement might of¬ 
fend programming purists. Here it is jus¬ 
tified because it provides a clean 
fashion for exiting complex routines 
whose undoing operations may be 
equally, if not more, complex. 

I prefer bulletproofing all of my 
routines in the above fashion. Many of 
my routines are general purpose ones 
that can be called by any other routine 
at any time. I don't rely on the calling 
routines to pass valid parameters (and 
that includes myself!). Yes, you may 
lose some “cycles” by guaranteeing that 
your application gracefully side-steps 
UAEs: I prefer that to a lightning-fast ap¬ 
plication that performs supersonic 
suicide! □ 


Listing 4 template.c 


/* 

* tempi ate.c 

* Written by Moshe Rubin 
*/ 

LPSTR FuncTemplate (LPSTR IpStr, HWND hWnd, int nVar) 

{ 

HANDLE hMem = NULL; /* Memory handle */ 

LPSTR lpMem = NULL; /* Memory pointer */ 

LPSTR Ret = NULL; /* Return value: initialize to “failure" */ 

/* Validate parameters */ 
if (llpStr) goto exit; 

if (IlsWindow (hWnd)) goto exit; 

if (ICheckParm (nVar)) goto exit; /* user-defined validity test */ 


/* An example of memory allocation/locking with error handling*/ 
if ((hMem = GlobalAlloc (...)) == NULL) goto exit; 
if ((lpMem * GlobalLock (hMem)) == NULL) goto exit; 

/* ... */ 

/* Function successful: set return value to non-failure */ 

Ret = lpMem; 

exi t: 

/* Test return value for "failure" */ 
if (Ret == NULL) 

{ 

/* Error occurred during function -- undo alloc/lock */ 
if (lpMem) GlobalUnlock (hMem); 

if (hMem) Global Free (hMem); 

} 

return (Ret); 

) 

/* End of File */ 
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A Ctrl-Alt-Del Intercept Routine 
For QuickBASIC 



George Toft 




Have you ever needed to prevent a user from terminating your program with a 
warm reboot? If so, you may have discovered that in languages such as Turbo Pas¬ 
cal, intercepting the Ctrl-Alt-Del sequence can be extremely complicated. You 
must write a procedure to execute whenever a key is pressed, declare it to be an 
interrupt-type procedure, and activate the procedure by inserting its address in the 
interrupt table. Within the procedure, you must examine every key pressed, filter 
out the ones you want, and pass all others on to the keyboard buffer. The much- 
maligned QuickBASIC, on the other hand, allows you to trap keys and reprogram 
them as you see fit. You define which keys you want to intercept, and the rest are 
sent to the keyboard buffer. This means you can intercept the Ctrl-Alt-Del reset 
and prevent it from occurring. Thus, instead of rebooting, your program could simply 
ignore the reset, finish processing, then end; or just display a message tell¬ 
ing the user not to reset the computer. 

In QuickBASIC, to intercept a keystroke such as Alt-A or Ctrl-Alt-Del, 
you must use it in a user-defined-key interrupt statement. Then, when this 
key combination is pressed, your program will be interrupted and the inter¬ 
rupt will be serviced; when the interrupt ends, program execution will return to the 
statement where the interrupt occurred. To perform this user-defined-key interrupt, 
your QuickBASIC program must define the keystrokes to be intercepted, define what 
label to transfer program control to, then enable interrupt processing for that 
keystroke combination. Unfortunately, QuickBASIC is very key-sensitive; therefore, if 
you have defined the keys Ctrl, Alt, and Del to be intercepted, and Caps Lock is 
on, QuickBASIC won't intercept the reboot and your computer will reset. This means 
you have to define and intercept all the keys that may be pressed at the same time 
as the three reboot keys — Num Lock, Caps Lock, Left Shift, Right Shift, etc. 
Because the 101-key keyboard has two delete keys, there are two different delete 
key codes to be intercepted, which doubles the number of keystroke sequences to 
be trapped. 


George Toft earned his Bachelor of Science in Computer Software in 1990. 
He is currently serving on active duty on board a nuclear fast attack sub¬ 
marine, and in his free time he writes computer-related articles. He can be 
reached at 92-902 Welo Street, #94, Makaki/o, Hawaii 96707. 
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Listing 2 Ctrl-Alt-Del intercept demonstration program 


■ 11 ■ ■ ■ 111 ■ ................................... 

tit* 1111 

Program name: CTRL-ALT-DEL intercept demo 


Written by: 
Language used: 
Libraries used: 


George Toft 
QuickBASIC 4.5 

QB.QLB (standard QB library) 


■ iii 1111 

................................ ■ 1111111111111111 


1 ========== Subroutine Declaration Section ============ 

DECLARE SUB CtrlAltDelMessage () 

DECLARE SUB DoSomething O 
DECLARE SUB InitCtrlAltDel () 

DECLARE SUB IntroProgram () 

DECLARE SUB GetKey (sfk AS INTEGER, char AS INTEGER) 
DECLARE SUB TerminateProgram () 


* ========== Type Definition Section =================== 

DEFINT A-Z 


1 ========== Program Execution Section ================= 

1 . Introduce program 

IntroProgram 


1 .Activate [Ctrl] [Alt] [Del] trap 

InitCtrlAltDel 


1 .Simulate activity 

DoSomething 


1 . Terminate program 

TerminateProgram 

END 


1 ================== [Ctrl] [Alt] [Del] Intercept ========== 

CtrlAltDelIntercept: 

CtrlAltDelMessage 

RETURN 

'SPage 

SUB CtrlAltDelMessage 

1 place window pop-up command here 
PCOPY 0, 1 

1 Purge input buffer 
DO WHILE INKEY$ <> *•" 

LOOP 

XPos = POS(O) 
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Listing 2 continued 


YPos = CSRLIN 

COLOR 12, 0 
LOCATE 6, 1 


PRINT 11 
PRINT " 
PRINT " 

Since this program stores temporary 

PRINT " 

information on disk, and resetting the 

PRINT " 

computer will adversely affect its 

PRINT “ 

future operation, the soft reset 

PRINT " 

feature has been disabled. 

PRINT " 
PRINT 11 

Press [Esc] to reset. 

PRINT " 

or [Enter] to resume program. 

PRINT " 



DO 

GetKey sfk, char 

LOOP UNTIL char = 13 OR char = 27 
IF char = 27 THEN 

1 place a call to the program's shutdown sequence here 

1 reset computer 
DEF SEG = &HFFFF 
CALL ABSOLUTE(O) 

ELSE 

1 place window remove routine here 
PCOPY 1, 0 

END IF 


The number of keys to be defined 
quickly becomes a problem, because 
QuickBASIC allows only 25 keys to be 
trapped. Of the 25, the first 14 are 
reserved for the 10 function keys and 
the 4 cursor keys, which leaves 11 keys 
for your use. The best solution to this 
problem is to define the keystrokes 
most likely to be encountered, e.g., the 
Caps Lock and Num Lock keys. Your 
decision here will be based on how the 
user will be using the program. If Num 
Lock and Caps Lock are never used, 
you may not have to trap these key 
combinations. 


A Small Illustration 

To illustrate the concept of key 
event trapping, I present a small ex¬ 
ample that traps the space bar. First, 
you define the keystrokes to be inter¬ 
cepted as follows: 

KEY 15, CHR$(&00) + CHR$(32)' 

[Space bar] 

The KEY command identifies the key 
event trap to use and the key code 
combination to trap. The key event trap 
number ranges from 1-25 (15 in this 
case). Numbers 1-10 are reserved for the function keys, 11-14 
for the cursor arrows, and 15-25 for whatever you want. The 
key code combination must specify the ASCII key being 
trapped and the keystroke modifiers, such as the Ctrl, Alt, 
Left Shift, Right Shift, Caps Lock, or Num Lock keys. 

Next, you must tell your program where to go when the 
trapped key (the space bar) is pressed. Assuming the interrupt 
label SpaceBarPressed exists in your program, this statement 
does just that: 


VISUAL PROGRAMMING FRAMEWORK 

Features: 
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• Select process icon from process toolbar 

• Each icon represents an application process class 
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• WYSIWYG interactive user interface generator 
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• Automatic program generator produces C+ + process class 

• New Features: macro and interactive runtime user inter- 


0N KEY(15) GOSUB SpaceBarPressed 


Listing 1 Sample key intercept 


KEY 15, CHR$(0) + CHR$(&H39)' [Space bar] 
ON KEY(15) GOSUB SpaceBarPressed 
KEY(15) ON 

DO 

PRINT "Press the Space Bar!!! 

FOR i = 1 TO 250: NEXT i' waste time 
LOOP UNTIL INKEY$ = CHR$(27) 

KEY(15) OFF 
END 

SpaceBarPressed: 

PRINT “ Thank You. 

RETURN 


face update 
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Listing 2 continued 


LOCATE YPos, XPos 


END SUB' CtrlAltDelMessage 
■SPage 

SUB DoSomething 


CLS 
PRINT 
PRINT 
PRINT " 

_ll 

STRING$(63, 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT " 

II 

SPACE$(63) 

PRINT » 

.11 

STRING$(63 

PRINT " 

II 

SPACE$(22) 

PRINT » 

<" 

STRING$(63, 


"f' 

Blocks remaining:"; SPACE$(24); 

— II). IIJ II 


II I II 


RANDOMIZE VAL(RIGHTS(TIMES, 2)) 

FOR i = 3000 TO 0 STEP -1 

COLOR 15, 0 

LOCATE 14, 49 

PRINT USING "####"; i; 

LOCATE 4 + 8 * RND, 2 + 62 * RND 
COLOR 15 * RND, 15 * RND 
PRINT CHR$(223 + 3 * (RND < .5)) 

NEXT i 

COLOR 7, 0 


END SUB' DoSomething 
'SPage 

SUB GetKey (sfk AS INTEGER, char AS INTEGER) 

char = 0 
sfk = 0 

DO' get input character 

CharlS = INKEYS 
IF CharlS <> »" THEN 

1 a key was pressed! 
char = ASC(CharlS) 

SOUND 250, .2 

IF char = 0 THEN 1 SFK pressed 
sfk = ASC(RIGHT$(Char1$, 1)) 
END IF 
END IF 

LOOP WHILE char = 0 AND sfk = 0 

END SUB 1 GetKey 
'SPage 


The interrupt label can be anywhere in 
your main module, except in a SUB or 
FUNCTION. The interrupt will not occur 
until the KEY .. . and ON KEY . . 

. statements have been executed, so 
place them where you need them — 
preferably at the beginning of your pro¬ 
gram. Keep in mind that the code fol¬ 
lowing the interrupt label is an interrupt 
routine and may be executed at any 
time. Follow good programming prac¬ 
tice: use variables local to that routine, 
don’t branch outside of the interrupt 
(SUB and FUNCTION calls are okay), and 
end the routine with a RETURN. (All of 
the QuickBASIC interrupts, except the ON 
ERROR interrupt, end with RETURN. The 
error-driven interrupt terminates with 
RESUME.) Remember that since the in¬ 
terrupt was executed with a GOSUB, it 
must end with a RETURN. It’s a good 
idea to put the interrupt routines at the 
end of your main module, after your 
END statement. 

Finally, you must activate the inter¬ 
rupt by telling QuickBASIC to turn it on. 
Activate the interrupt by inserting this 
line in your code: 

KEY(15) ON 

As you might imagine, if you can ac¬ 
tivate an interrupt, you can also deac¬ 
tivate it. In fact, you can suspend or 
cancel the interrupt altogether. To 
suspend an interrupt, use the command 
KEY(n) STOP, where n is the interrupt 
number. QuickBASIC will remember that 
the interrupting event occurred, but 
won’t interrupt your program. When 
QuickBASIC executes another KEY(n) 
ON, the interrupt will occur. KEY(n) OFF 
cancels the interrupt completely —as if 
you had never defined it. To reactivate 
the interrupt, use the KEY(n) ON state¬ 
ment. 

Normally, these three lines will ap¬ 
pear together. If you need to intercept 
more keys, place their definition, label, 
and activation sequences together at 
the beginning of your program. Also 
note that you can redefine keys and in¬ 
terrupt labels as you wish throughout 
your program. 

Listing 1 completes the demonstra¬ 
tion. The program uses an infinite loop 
to continually display the command to 
press the space bar. When the space 
bar is pressed, the interrupt routine 


Page 70 — Windows/DOS Developer’s Journal 


March 1993 












Listing 2 continued 


SUB 


’ [Caps Lock] [Ctrl] 
KEY 16, CHR$(&H4C) + 


prints “Thank You," then returns to the 
infinite loop. Press the Escape key to 
exit the program. 

A Ctrl-Alt-Del Intercept 

The simple program in Listing 2 in¬ 
tercepts the Ctrl-Alt-Del keys while 
showing continually changing color 
blocks on your screen. The program 
contains six subroutines along with the 
main program, which coordinates their 
invocation. 

The program first declares the sub¬ 
routines and defines all variables to be 
integers, then presents the program’s 
introduction. 

The program next calls the sub¬ 
routine InitCtrlAltDel, which initial¬ 
izes the Ctrl-Alt-Del intercept 
routines. Keep in mind that the labels 
specified in this subroutine must reside 
in the current module: they can’t reside 
in another module, nor can they be in a 
subprogram (this is a carryover from the 
days of Microsoft’s interpreted BASIC, 
where everything existed in one 
module). 

The subroutine DoSomething 
provides a screen of color “static" by 
displaying 3,000 random blocks with random colors at random 
locations. While this routine is running, press the Ctrl-Alt- 
Del keys and observe the message, then try different com¬ 
binations, such as Ctrl-Alt-Del-Left Shift, or Ctrl-Alt- 
Del-Caps Lock. After the 3,000 blocks have displayed, the 
program calls the subroutine TerminateProgram and ter¬ 
minates. 

What happens here is that, when Ctrl-Alt-Del is pressed, 
program control transfers to the label CtrlAltDellntercept, 
which is in the main module and calls the subroutine Ctrl- 
AltDelMessage. After the message is displayed and acknow¬ 
ledged, the subroutine ends, and control returns first to the 
RETURN statement in the main module and then to the state¬ 
ment where the Ctrl-Alt-Del interrupt occurred. Note that 
this routine is intended to be included in your programs with 
a pop-up message which will be erased after acknow¬ 
ledgment. If you are using pop-up windows, you'll need to 
place your own routines at the points indicated in the code. 
Listing 2 uses the PCOPY statement to simulate saving the 
screen for pop-up windows. Remove the PCOPY statements if 
you are using pop-up windows; if you aren’t using pop-up 
windows, ignore the remarks. 

The text is printed entirely on the left side of the screen in 
order to keep the program simple, yet functional and instruc¬ 
tional. To add center print commands, or a LOCATE statement 
before every PRINT, would needlessly complicate the 
program’s purpose. 

One final note about using the Ctrl-Alt-Del intercept: 
while it will prevent crashing your program from the key¬ 
board, it can’t intercept the hardware reset (reset button), 


InitCtrlAltDel 
1 intercepts Ctrl-Alt-Del 

1 [Ctrl] [Alt] [Del] 

KEY 15, CHR$(&HC) + CHR$(83) 


[Alt] [Del] 
CHR$(83) 


1 [Num Lock] [Ctrl] [Alt] [Del] 
KEY 17, CHR$(&H2C) + CHR$(83) 


' [Left Shift] [Ctrl] [Alt] 
KEY 18, CHR$(&HE) + CHR$(83) 


[Del] 


' [Caps Lock] [Num Lock] [Ctrl] [Alt] [Del] 
KEY 19, CHR$(&H6C) + CHR$(83) 

1 [Ctrl] [Alt] [Extended Del] 

KEY 20, CHR$(&H8C) + CHR$(83) 

1 [Caps Lock] [Left Shift] [Ctrl] [Alt] [Del] 
KEY 21, CHR$(&H4E) + CHR$(83) 


' [Caps Lock] [Num Lock] [Left Shift] 
KEY 22, CHR$(&H6E) + CHR$(83) 


[Ctrl] [Alt] [Del] 


1 [Caps Lock] [Num Lock] [Left Shift] [Ctrl] [Alt] [Extended Del] 
KEY 23, CHR$(&HEE) + CHR$(83) 


' [Caps Lock] [Left Shift] [Ctrl] [Alt] 
KEY 24. CHR$(&HCE) + CHR$(83) 


[Extended Del] 


'Jo claim the territory, 
have a trustworthy guide. 



(Rapture international markets by making your 
software easy to localize! Let InternaX videotapes, 
with Windows and Windows NT expert Dr. William 
Hall, show you how to design or retrofit your soft¬ 
ware for global success! 

For details, phone or fax 

(408) 438-2270 

InternaX 

6 Johnston Way, Scotts Valley, CA 95066 

Windows™ is a registered trademark of Microsoft Corporation 
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Listing 2 continued 


ON KEY(15) GOSUB 
ON KEY(16) GOSUB 
ON KEY(17) GOSUB 
ON KEY(18) GOSUB 
ON KEY C19 > GOSUB 
ON KEY(20) GOSUB 
ON KEY(21) GOSUB 
ON KEY(22) GOSUB 
ON KEY(23) GOSUB 
ON KEY(24) GOSUB 

KEY(15) ON 
KEY(16) ON 
KEY(17) ON 
KEY(18) ON 
KEY(19) ON 
KEY(20) ON 
KEY(21) ON 
KEY(22) ON 
KEY(23) ON 
KEY(24) ON 


CtrlAltDelIntercept 
CtrlAltDellntercept 
CtrlAltDelIntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 
CtrlAltDellntercept 


END SUB 1 InitCtrlAltDel 


■$Page 

i 

SUB IntroProgram 


CLS 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 


This program demonstrates the CTRL-ALT-DEL 
intercept using QuickBASIC. The program 
will flash blocks in random locations on 
the screen. You may press CTRL-ALT-DEL 
anytime after the blocks begin appearing. 


Press [Enter] to begin the demonstration. 


DO 

GetKey sfk, char 
LOOP UNTIL char = 13 


END SUB 1 IntroProgram 
■SPage 

SUB TerminateProgram 
CLS 

PRINT "Thank you for trying the "; 
PRINT "CTRL-ALT-DEL intercept demo." 


1 turn off all intercepted keys 

KEY(15) OFF 

KEY(16) OFF 

KEY(17) OFF 

KEY(18) OFF 

KEY(19) OFF 

KEY(20) OFF 

KEY(21) OFF 

KEY(22) OFF 

KEY(23) OFF 

KEY(24) OFF 


END SUB' TerminateProgram 


which is tied directly to the hardware 
interrupt controller and therefore can¬ 
not be intercepted. 

Conclusion 

By intercepting the Ctrl-Alt-Del 
and the Ctrl-Break keys, you ensure 
that you have complete control over 
your program. Your users won’t be able 
to abort the program or to use Ctrl- 
Alt-Del to reset the computer until the 
program is finished. This allows you to 
use temporary files without worrying 
about leaving residue on the disk drive. 
It’s a simple concept to implement and 
a cheap insurance policy against ac¬ 
cidental program terminations. □ 
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shareware C source code. Every 
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Call, FAX or write: 

The C Users’ Group 
1601 West 23rd St., Suite 200 
Lawrence, KS 66046-2743 
913-841-1631 
FAX 913-841-2624 


Page 72 — Windows/DOS Developer’s Journal 


March 1993 



















Automatic Help Topic Printing 

Ron Burk 


The Windows help engine (winhelp.exe) lets the end user print whatever help 
topic is currently displayed. Unfortunately, the engine does not let the user print 
more than one topic. Windows programmers have had ample reason to curse this 
shortcoming, since Microsoft delivered the Windows 3.1 beta documentation in the 
form of a help file. Printing the new documentation can literally require hours of 
hand-picking topics then selecting “Print Topic” from the “File" menu. If you try to 
design a help file that lets the user print more than one topic at a time, you will 
encounter problems that require you to reverse-engineer information about Win¬ 
dows help that Microsoft failed to document. This article describes those problems 
and presents code you can use to work around them. 

helprint.c (Listing 1) contains the code for a DLL that can help you create help 
files capable of printing multiple help topics. You may wish to refer to it as you read 
the following discussion of the problems of help topic printing. 

The Trouble with Print () 

My goal is to end up with a WinHelp button that prints a set of help topics. The 
Windows 3.1 help engine provides a Print 0 macro that prints the current topic, as 
if you had selected “Print Topic” from the “File" menu. That macro is crucial to any 
help topic printing scheme, since Microsoft provides no documented method of ac¬ 
cessing the text in a given help topic (except by copying it to the clipboard, which 
loses most formatting information). Somehow, my proposed WinHelp button must 
jump to each of the desired topics and execute the Print () macro. 

In my earlier article on automatic help topic extraction (January 1993), I showed 
how you can construct a linked list of help topics by using footnote macros and the 
IfThen() macro. The idea is that you begin the traversal of the linked list by execut¬ 
ing a macro string similar to this one: 

!SetMark('MyList') ;JumpId(" ,"Topic_l") 


;PT1 


Borland C++ v3.l 
Microsoft C/C++ v7.0a 
Zortech C++ v3.1 


Ron Burk has a BSEE from the University of Kansas and has been a programmer for 
12 years. He is working on a book tentatively titled WinHelp for Programmers and 
Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. BIX: rlburk; Internet: ronb@rdpub.com (". . . 

luunetlrdpublronb") 
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Listing 1 helprint.c — DLL for printing multiple help topics 


/* 

* helpapi.c - DLL to provide multi-topic printing. 

* Copyright (c) Ron Burk 1993 
*/ 

linclude <stdlib.h> 

#include <windows.h> 

Idefine WM_HELP_INQUIRE (1) /* asks what notifications you want */ 

Idefine WM_HELP_FUNCPTRS (10) /* supplies pointers to functions */ 

Idefine HN_FUNCPTRS (0x0010) /* bit to receive WM_HELP_FUNCPTRS */ 

typedef LONG (CALLBACK *WINHELPPTR)(LPSTR,WORD,DWORD); 
typedef struct Helplnstance 

f 

struct Helplnstance *Next; 

HTASK TaskHandle; 

WINHELPPTR WinHelp; 

} Helplnstance; 

Helplnstance *HelpList; 

Helplnstance *NewHelpInstance(FARPROC FAR *FuncPtrs) 

( 

Helplnstance *This; 

This = (Helplnstance *)malloc(sizeof(Helplnstance)); 

if (This ! = NULL) 

{ 

This->Next = NULL; 

This->TaskHandle = GetCurrentTask(); 

This->WinHelp = (WINHELPPTR)FuncPtrs[16]; 

if (HelpList) 

( 

This->Next = HelpList; 

HelpList = This; 

) 

else /* else first on list */ 

HelpList ■ This; 

) 

return This; 

) 

Helplnstance *CurrentHelpInstance(void) 

( 

HTASK ThisTask = GetCurrentTask(); 

Helplnstance *Rover ■ HelpList; 

while(Rover) /* search linked list for matching task */ 

]f(Rover->TaskHandle == ThisTask) 
return Rover; 

else 

Rover = Rover->Next; 
return Rover; 

) 


HINSTANCE ModuleHandle; 

/* LibMain - store module handle, register clipboard format */ 

lifdef _BORLANDC_ 

Ipragma argsused 
lendif 

int CALLBACK LibMain(HINSTANCE ModuleHandle_, 

WORD DataSegment, WORD HeapSize, LPSTR CommandLine) 

( 

if(HeapSize > 0) 

UnlockData(O); 

ModuleHandle = ModuleHandle_; 
return 1; 

) 


You could attach this initial macro 
string to a button by calling the 
CreateButtonf) macro or to a menu 
item by calling the Appendltem() 
macro. Each topic in the list must con¬ 
tain a footnote macro something like 
this: 

!IfThen(IsMark('MyList'), \ 

"Print() ;JumpId('' ,’Topic_n')") 

Finally, the last topic in the chain must 
remove the flag and return to the 
original topic: 

!ifThen(IsMark('MyList'), \ 

"Print() ;DeleteMark('MyList'); 
Jumpld('' ,'Topic_n')") 

This linked list of topics depends upon 
the fact that footnote macros get in¬ 
voked whenever WinHelp jumps to the 
corresponding topic. Each topic prints it¬ 
self and then jumps to the next topic, 
which invokes that topic’s footnote 
macro, and so on. 

This scheme would work except for 
WinHelp's undocumented tendency to 
execute Help macros asynchronously. In 
this case, as soon as WinHelp en¬ 
counters a macro after the first Print () 
in the list, it produces an error message 
to the effect that it cannot execute 
another macro until the Print() macro 
completes. 

Synchronizing WinHelp 

The problem is that when WinHelp 
sees a Print() macro, it does not finish 
printing before it continues to read the 
next macro. This seems like an absurd 
design — the error message might as 
well say “You cannot have a macro 
string that contains Print () unless it is 
at the very end." I first encountered the 
problem of synchronizing WinHelp 
macro execution when I was using the 
Copy Top ic() macro to copy topics to 
the clipboard and, from there, to exter¬ 
nal files. In the case of CopyTopicf), 
WinHelp does not even emit an error 
message; the data simply is not in the 
clipboard when you check for it. 

To get around this WinHelp 
asynchronicity, I wrote an initialization 
macro (a DLL routine) that set the clip¬ 
board to a dummy format. I executed a 
CopyTopic () macro and then called my 
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own macro (another DLL routine) that 
sat in a loop, getting and dispatching 
messages for WinHelp until the data ap¬ 
peared in the clipboard. 

Since then, however, I have dis¬ 
covered that a simple message pump 
seems to work as a general method of 
synchronizing (forcing it to finish 
whatever it has started) Winhelp. In 
other words, whenever you need to 
synchronize WinHelp, execute a loop 
like this in your DLL: 

whi1e(/* PeekMessage returns 1 */ ) 

{ 

/* translate and 
dispatch message */ 

} 

This approach made it easier to extract 
files via CopyTopicf) since I no longer 
had to call a DLL routine to initialize the 
clipboard each time. 

You might think that knowing how 
to synchronize WinHelp would solve 
the problem. You could write a DLL 
routine called Synchronize() that con¬ 
tains a message pump, use Register- 
Routine () to make it callable from 
your helpfile, and follow every call to 
Print() with a call to Synchronize(). 
Remember, however, that WinHelp tries 
to be helpful in its own demented way 
by emitting an error message if any 
macro call follows a call to Print(). 

The solution is to let your DLL ex¬ 
ecute the Print () macro rather than 
putting a call to Print () in your help 
file. Your DLL can execute any macro 
via a call to Min He Ip () like this: 

WinHelp(hWnd,"helpfi1e.hip", 
HELP_COMMAND, "Print()“); 

where hWnd is the same window handle 
your application passed to UinHelpO 
when it originally displayed the help 
file. Passing this window handle from 
your application to the DLL can be dif¬ 
ficult if you want to handle multiple in¬ 
stances of your application. However, if 
you want to ignore the problem of mul¬ 
tiple application instances, your applica¬ 
tion could just call an initialization func¬ 
tion in the DLL, passing in the window 
handle it will use with WinHelpf). The 
DLL could store this window handle in a 
global variable and use it in its own 
calls to MinHelp(). 
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/* WEP - return success */ 

lifdef _BORLANDC_ 

#pragma argsused 
#endif 

int CALLBACK WEP(int ExitCode) 
( 

return 1; 

) 


/* HelpYieldO 
static void 
{ 


- Synchronize winhelp.exe macro execution */ 
HelpYield(void) 
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Putting the call to the Print () macro in the DLL lets you 
call a message pump to wait for the Print () macro to com¬ 
plete, and keeps WinHelp from knowing that you're going to 
execute another macro after the Print () macro. That's all 


Listing 2 helprintdef — Module definition file for 
helprintc 


LIBRARY HELPRINT 

DESCRIPTION 'HELPRINT - Allow printing multiple help 
topics' 

STUB 'WINSTUB.EXE' 

EXETYPE WINDOWS 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE SINGLE 

HEAPSIZE 16096 


EXPORTS 

WEP 


@1 RESIDENTNAME 



MSG 


Message; 


while(PeekMessage(&Message, NULL, 0, 0, PM_REM0VE)) 
if(Message.message == WM_QUIT) 

{ 

PostQuitMessage(O); 
return; 

} 

else 

{ 

TranslateMessage(&Message); 
DispatchMessage(&Message); 

} 

} 

/* PrintThis() - prints current topic in given help file */ 
void CALLBACK _export PrintThis(char FAR *HelpFi1e) 

( 

Helplnstance *ThisHel p = CurrentHelpInstanceO ; 

ThisHelp->WinHelp(HelpFi1e, HELP_C0MMAND, 

(DWORD) (void FAR *) "PrintO"); 

HelpYieldO; 

) 


you need to know to create application help files that can 
print multiple topics at the press of a button. 

What if your help file is a standalone —i.e., a file that was 
not started by an application, but by a command line like 
"winhelp myhelp.hlp "? If you want to be able to print multi¬ 
ple topics from a standalone help file, you have a lot more 
work in store. 

The Standalone Probem 

The first time an application calls UinHelpO, Windows 
starts up an instance of winhelp.exe to handle the request 
(usually resulting in the display of a help window). If a second 
application then calls UinHelpO, the same instance of win¬ 
help.exe handles the request - Windows does not start a 
separate copy of winhelp.exe for the second application. A 
single copy of winhelp.exe services all the applications that 
have called UinHelpO to display online help at any one time. 
Like a DLL, winhelp.exe has to manage resources for multiple 
applications that are requesting its services. 

Like a DLL, winhelp.exe needs some way to associate in¬ 
ternal data with each application in¬ 
stance that requests its services. Thus, 
UinHelpO requires your application to 
pass it a window handle at every call, 
which it presumably associates with in¬ 
ternal data for your application's help 
session. In order to free up those inter¬ 
nal resources, your application is sup¬ 
posed to call UinHelpO and pass it the 
HELP_QUIT code before it closes the 
window that it passed to start up the 
help window. When all of the applica¬ 
tions using winhelp.exe have passed it 
a HELP_QUIT code, winhelp.exe can 
finally terminate. 

A standalone help file is a different 
kettle of fish. Consider the Windows 3.1 
SDK help file that describes the Win¬ 
dows API. Most programmers will use it 
as a standalone help file. In other 
words, they create a Program Manager 
group item that has a command line 
something like this: 


/* LDLLHandler - Special function that WinHelp calls implicitly */ 

lifdef _BORLANDC_ 

Ipragma argsused 
#endif 

LONG CALLBACK _export LDLLHandler(WORD Message, LONG Paraml, LONG Param2) 
( 

switch(Message) 

{ 

case WM_HELP_INQUIRE : 

return HN_FUNCPTRS; 
case WM_HELP_FUNCPTRS : 

NewHelpInstance((FARPROC FAR *)Paraml); 
return TRUE; 

) 

return FALSE; 

1 

/* End of File */ 


winhelp c:\sdk\bin\win31wh.hlp 

Every time a user executes a command 
line of this type, Windows starts a 
separate instance of winhelp.exe. 

How can a DLL routine for a stan¬ 
dalone help file call UinHelpO to 
operate on that file? After all, the first 
argument to UinHelpO is the handle of 
the window you used when you called 
UinHelpO to display the help file 
originally. But this is a Catch-22, since 
your DLL never called UinHelpO to dis¬ 
play the help file - the user executed 
winhelp.exe to do that! So what window 
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handle should your DLL use to identify 
the help file it wants UinHelpO to 
operate on? 

A logical choice might be the handle 
of the main help window. It’s easy 
enough to obtain this handle if you 
Know about the predefined WinHelp 
variables that Microsoft did not docu¬ 
ment in the Windows 3.1 SDK. For ex¬ 
ample, here's how to pass the handle of 
the main help window to a DLL routine: 

RR("mydll.dll“,"PrintThis","i=U") 
PrintThis(hwndMain) 

This passes an unsigned long (contain¬ 
ing the handle of the main help win¬ 
dow in the lower 16 bits) to the DLL 
routine PrintThisf). PrintThisf) 
could then use this handle in a call to 
UinHelpO to execute the Print() 
macro. 

Unfortunately, this scheme doesn't 
work. When you pass this window 
handle to UinHelpO to execute a 
macro, UinHelpO does not return an 
error — it simply does not execute the 
macro. The solution lies in the internal 
winhelp.exe API that Microsoft docu¬ 
mented in the Multimedia Development 
Kit but did not document in the Win¬ 
dows 3.1 SDK. One of winhelp.exe's in¬ 
ternal functions gives you direct access 
to the same functionality that Uin¬ 
HelpO provides indirectly, and it re¬ 
quires no identifying window handle. 

LDLLHandlerf) 

The key to winhelp.exe's internal 
API is a function called LDLLHandler(). 
When winhelp.exe loads your DLL 
(presumably because you referred to 
your DLL in a RegisterRoutine() 
macro) it checks to see if you have ex¬ 
ported a function called “LDLLHandler”. 
Listing 1 shows the declaration for 
LDLLHandlerO ; I have invented my 
own constant names for use with this 
function, so that you do not have to 
purchase the Multimedia Development 
Kit just to obtain a header file. 

If your DLL exports a function called 
LDLLHandlerO , winhelp.exe will call it, 
passing a message number of 
UM_HELP_INQUIRE. At this point, your 
LDLLHandlerO should return a bit 
mask that indicates which notifications 
it wants to receive. Your DLL can be 
notified of a variety of WinHelp events, 


Listing 3 helprint.hpj - Help project file to demonstrate helprint.dll 


[Options] 

Copyright="Copyright (c) 1992 Ron Burk" 

[Files] 

intro.rtf 

[Config] 

RegisterRoutineC'helprint.dlT', "PrintThis", "S") 

CB(“mprint",“Print &A11"."SaveMarkfprintall'):JI(' 1 ,'topicl')") 
[Windows] 

main * "Demonstrate helprint.dll",(0,0,1023,512), 0,, (192,192,192) 


COMPUTER 


LANGUAGE 




5.0 presents 
C Bug # 542 



PC-lint will catch this and many other 

C bugs. Unlike your compiler, PC-lint 
looks across all modules of your 
application for bugs and inconsistencies. 

More than 330 messages. Includes 
optional Strong Type Checking and 
flow of control analysis. More than 105 
options for complete customization. 
Suppress error messages, locally or 
globally, by symbol name, by message 
number, by filename, etc. Check for 
portability problems. Alter size of 
scalars. Adjust format of error 
messages. Automatically generate ANSI 
prototypes for your K&R functions. 


Attn: Power users with huge programs. 

PC-lint 386 uses DOS Extender 
Technology to access the full storage 
and flat model speed of your 386. 

PC-lint 386-$239 
PC-lint DOS - OS/2 - $139 

Mainframe & Mini Programmers 
FlexeLint ill obfuscated source 
form, is available for Unix, OS-9, 
VAX/VMS, QNX, IBM VM/MVS, etc. 
Requires only K&R C to compile but 
supports ANSI. Call for pricing. 



3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (215)584-4261 Or FAX (215)584-4266 

30 Day Money-back Guarantee. 

PA add 6% sales tax. PC-lint and FlexeLint are trademarks of Gimpel Software 
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Listing 4 introl.rtf — Text of demonstration help file 


(\rtfl\ansi \deff0\deflongl024(\fonttbl(\fO\froman Times;}} 
\pard\p1ain \fs20\langl033 {\fsl6\up6 
!{\footnote \pard\plain \s245 \fs20\langl033 {\fsl6\up6 !} 
IfThen(IsMark(“printal1").“PrintThisfqchPath);JI ('* ,'topic2')“) 

}}{\fsl6\up6 #{\footnote \pard\plain \s245 \fs20\langl033 
(\fsl6\up6 #}topicl}}{\fsl6\up6 $(\footnote \pard\plain 
\s245 \fs20\langl033 {\fsl6\up6 $} Topic 1!}} 

This is topic # 1. There is one other topic in this help file. 
Press the “Print All" button to print both of them. 

\par \pard \page {\fsl6\up6 !{\footnote \pard\plain \s245 
\fs20\langl033 (\fsl6\up6 !} 

IfThen(IsMark(“printall“)."PrintThis(qchPath); 
OeleteMark('printal1 1 ); JI (' 1 ,'topicl 1 )") 

}} (\fsl6\up6 #(\footnote \pard\plain \s245 \fs20\langl033 
(\fsl6\up6 #} topic2}}{ 

\fsl6\up6 ${\footnote \pard\plain \s245 \fs20\langl033 
(\fsl6\up6 $}Topic 2!}} Topic # 2 
\par } 


including when the user jumps to a new help topic. In this 
article I am only interested in receiving a special message that 
is not really a notification of any kind of event. I have labeled 
the bit (0x0010) that causes WinHelp to send this special 
“notification" HN_FUNCPTRS, since it causes winhelp.exe to 
pass an array of function pointers to LDLLHandler(). 

After your LDLLHandler() returns HN_FUNCPTRS in response 
to the WM_HELP_INQUIRE message, winhelp.exe will call your 
LDLLHandler() again, this time with a message number of 
m HELP FUNCPTRS. In Paraml, winhelp.exe passes a far 


Finally, Windows and OS/2 
Training For a Reasonable Price. 

$500 

per student for five-day classes 1 

$10,000 

for five-day onsite classes 2 

Our competitors charge up to $1850 for a class, but we 
are located in Cedar Rapids, IA, where our costs are low, so yours 
are, too. But these are the same high-quality, guaranteed workshops 
that we’ve been providing for IBM and other companies since 1983. 

Since that time, we have trained over 8,000 
programmers. And our class evaluations show that over 90 percent 
of our students were very satisfied with the class. 

To enroll, or to get a workshop schedule, call (319) 362- 
3906 or fax us at (319) 362-3701. P.O. Box 461 Marion, IA 52302 


0 


DESCRIPTOR SYSTEMS 

"We Bring You Up to Speed" 


□ C Programming □ C++ Programming 
□ Windows Programming □ Windows NT Programming 
□ OS/2 Kernel Programming □ Presentation Manager Programming 
□ Workplace Shell Programming 

1 At Cedar Rapids. Introductory price until 5/93; $750 after that date 
: At your site. Call for details Trademarks owned by their respective companies 


□ Request 123 on Reader Service Card □ 
Page 78 - Windows/DOS Developer’s Journal 


pointer to an array of function pointers. 
These point to functions within win¬ 
help.exe, and they provide a variety of 
operations that are mentioned, but not 
very well documented, in the Microsoft 
Multimedia Development Kit. 

Once again, this article requires ac¬ 
cess to only a part of winhelp.exe' s 
functionality, so the code ignores all of 
the function pointers except one: Uin- 
Help() (offset 16 in the function pointer 
array). This function operates in nearly 
the same way as the Windows API 
function UinHelpf). The difference is 
that this function requires only three 
parameters instead of four —it does not 
require a window handle as a first ar¬ 
gument. By using this internal version 
of MinHelpO, you can execute the 
Print () macro from your DLL called by a standalone help file. 

Multiple Instances 

One remaining problem is multiple instances. When your 
LDLLHandler() receives the UM_HELP_FUNCPTRS message, 
those function pointers point inside an application ( win¬ 
help.exe), not a DLL. The MDK documentation says that those 
function pointers will be different for different instances of 
winhelp.exe. Presumably, this is because the pointers point, 
not to the actual code inside of winhelp.exe, but to thunks 
created with MokeProcInstance() , so that the DS register is 
set to the correct value for each instance of winhelp.exe. 

In general, your LDLLHandler() has to be prepared to 
receive more than one UM_HELP_FUNCPTRS message, and it has 
to use the function pointers that correspond to the correct 
instance of winhelp.exe. The code in helprint.c (Listing 1) 
keeps a linked list of pointers to internal winhelp.exe func¬ 
tions, each associated with the handle of the current task at 
the time the function pointers were received. When 
helprint.c needs to call an internal winhelp.exe function, it 
gets the handle of the current task and finds the correspond¬ 
ing function pointer. This scheme should work well so long as 
the functions in helprint.c are only called by winhelp.exe, 
not by your application. 

Summary 

helprint.c (Listing 1) contains the source code for the DLL; 
the corresponding module definition file is helprint.def (List¬ 
ing 2). I created a simple two-topic help file with a “Print All” 
button to demonstrate how to use the DLL. The help project 
file is helprint.hpj (Listing 3) and the text of the help file is 
in intro.rtf (Listing 4). 

The feature probably most often requested by users of on¬ 
line help is the ability to print more than one topic at a time. 
The code in this article can help you create help files that will 
let the user print any set of help topics at once. You can 
design the help file to print groups, or even all of the help 
topics in your file. The extra effort involved will make your 
help file more useful to the end user. □ 
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New Products 

Industry-Related News & Announcements 


Symantec Updates Zortech C++ 

Symantec has released two new versions of its Zortech 
C++ compiler: Zortech C++ v3.1 for DOS and Windows 3.1, and 
Zortech C++ v3.1 for OS/2 2.0. The new compilers are com¬ 
pliant with AT&T Cfront C++ v3.0 and ANSI C, and offer sup¬ 
port for both precompiled headers and C++ templates. 
Zortech C++ conforms to both the IEEE-754 floating-point stand¬ 
ards and the NCEG 91-015 draft for numerical extensions. 

Zortech C++ v3.1 for DOS and Windows 3.1 comes with 
the Multiscope Debuggers and the Whitewater Resource 


Toolkit The new version of the compiler includes support for 
multimedia, OLE, DDE, pen extensions, and TrueType fonts. 
The DOS version of the compiler supports 32-bit program¬ 
ming. 

Zortech C++ v3.1 for DOS and Windows 3.1 costs $499; 
Zortech C++ v3.1 for OS/2 2.0 also costs $499. For more infor¬ 
mation, contact Symantec Corporation, 10201 Torre 
Avenue, Cupertino, CA 95014-2132, (408) 253-9600; FAX 
(408) 253-4092; Telex 9103808778. 


TrackDeck Aids Windows and OS/2 Debugging 


Dashboard Software has released TrackDeck, a new 
programmer's utility for Windows and OS/2 developers. 
TrackDeck lets you examine any variable in your code and 
track its value as your program executes at its normal 
speed. TrackDeck’s control panel lets you set up permanent 
displays of crucial parameters to check for bugs or perfor¬ 
mance problems. 

Inside your code, you tell TrackDeck the address of any 
variables you want to watch. To see the variable values, you 
bring up a dashboard window side-by-side with your pro¬ 
gram window. You can display the data as text, a dial, or a 


time-graph, with complete control over size, color, axis, and 
time units. You can examine how fast a variable changes or 
display its average, maximum, or minimum value. You can 
also make the monitored variable values available to other 
applications via a DDE link. 

TrackDeck works with any language that can access 
DLLs. There are special interface components for C/C++, 
Visual Basic, Turbo Pascal for Windows, and Object Vision. 
The introductory price for TrackDeck for Windows is $129. 
For more information, contact Dashboard Software, 4 Louis 
Avenue, Monsey, NY 10952, (914) 352-8071. 


Guidance Introduces Choreographer v3.0 

Choreographer is a new version of Guidance 
Technologies' corporate application development software, a 
tool for developing cooperative computing, client/server ap¬ 
plications, and text-to-GUI conversions. Choreographer v3.0 
supports both OS/2 and Windows with a single product - 
Choreographer applications are binary compatible between 
the two platforms while still exploiting the individual ad¬ 
vantages inherent in each operating system. 

Supporting OS/2 2.0's 32-bit architecture, Choreographer 
v3.0 also supports IBM’s CUA 91-widget control set, including 

object-Menu Enters Windows Arena 

object-Menu is an object-oriented class library for 
developing user interfaces. Its basic elements include win¬ 
dows, menus, dialog boxes, list boxes, spin controls, combo 
boxes, file choosers, file scroller windows, analog-style 
sliders, and a context-sensitive help display. 

The previous version of object-Menu was for DOS, but ob¬ 
ject-Menu v2.0 now supports Windows - developers use ob¬ 
ject-Menu to produce a single-source application that can be 
compiled for either Windows or DOS. Extra features available 
in object-Menu for DOS are also available under Windows, in¬ 
cluding the ability to attach menus, toolbars, and dialogs in 


sliders, spin buttons, notebooks, containers, and drag-and- 
drop. Choreographer v3.0 also provides enhanced SQL 
database encapsulation for NetWare, Microsoft and Sybase 
SQLServer, and IBM Database Manager. Choreographer’s 
patented Display Object Editor, previously available only 
under OS/2, is now also available for Windows. 

Choreographer costs $7500. For more information, con¬ 
tact Guidance Technologies, Inc., 800 Vinial Street, Pit¬ 
tsburgh, PA 15212, (412)J31-1300; FAX (412) 231-2076. 


any position in a window and the ability to have menus 
with multiple active icons. Also, developers have the option 
of updating the flat Windows look to the Motif style. 
Developers can create Windows and DOS help from one com¬ 
mon text file. An included utility writes RTF files from a 
generic help file that can be created with any text editor. 

object-Menu v2.0 costs $369; source code costs an addi¬ 
tional $529. For more information, contact Island Systems, 7 
Mountain Road, Burlington, MA 01803, (617) 273-0421; 

FAX (617) 270-4437. 
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Positive Updates Windows Editor 

ix v2.1 is the new version of ix, a professional program¬ 
ming editor for Windows. The new version offers improved 
reliability and a more configurable Project Browser, with the 
ability to change fonts, colors, and icon spacing, plus user- 
definable icons. Version 2.1 offers tags in regular expression 
search-and-replace operations. The product is still com¬ 


patible with Windows 3.0 but follows user interface 
guidelines for Windows 3.1. 

ix v2.1 costs £95 + VAT; a free demonstration copy is 
available on request For more information, contact Positive 
Ltd, 22 Westminster Buildings, 31 New York Street, Leeds, 
ENGLAND LS2 7DT, (0532) 343 104. 


LabWindows Adds New Compiler Support 

National Instruments has updated its LabWindows for 
DOS instrumentation software to include standalone libraries 
for Borland C++ and Turbo C++ and the Microsoft Visual Basic 
for DOS compiler. Users can now access the Borland compiler 
and linker from within the LabWindows programming en¬ 
vironment to create executable programs, or they can add 
the LabWindows libraries to the Borland IDE for program 
development Each of the LabWindows libraries has a Bor¬ 
land-compatible help file that users can load into the IDE for 
online help. BASIC programmers using VBDOS can likewise in¬ 
corporate LabWindows instrumentation functionality into 
their application. 


The LabWindows libraries are compatible with Borland 
C++ v2.0, v3.0, and v3.l, Turbo C++ v3.0, and Microsoft VBDOS 
vl.O. Existing LabWindows v2.2 users can receive the 
upgrade at no charge. LabWindows V2.2.1 costs $695 for the 
Standard Package and $895 for the Advanced Analysis 
Library. Upgrades from previous versions cost $195. For more 
information, contact National Instruments, 6504 Bridge 
Point Parkway, Austin, TX 78730-5039, (512) 794-0100 or 
(800) 433-3488; FAX (512) 794-8411. 


CCC/Manager Supports Windows NT 

CCC/Manager is now available for Windows NT. 
CCC/Manager helps programmers manage software changes 
during software development and maintenance. It lets 
programmers store, retrieve, and manipulate multiple ver¬ 
sions of files, from source Files to executables and spread¬ 
sheets. The product provides check-in and check-out for 
group software development 

CCC/Manager provides virtual views for each version of 
an application. It fully supports “branches” and “application 


snapshots.” Users can implement individual changes and 
manage them in a packaged format CCC/Manager operates 
on networks and on standalone PCs. 

CCC/Manager for Windows NT costs between $556 and 
$695 a copy, depending on the number of licenses. For more 
information, contact Softool Corporation, 340 S. Kellogg 
Avenue, Goleta, CA 93117, (805) 683-5777-, FAX (80S) 683- 
4105. 


WindList Adds Info Button 

WindList is a Windows task manager that allows you to 
interactively change most window characteristics, such as 
title, caption, visibility, and so on. WindList vl.7 has a new 
“Info” button that provides additional information on tasks, 
modules, and window classes. The window class information 
dialog shows the names of the window classes as well as all 
their characteristics, including their default icon, cursor, and 
background brush. The class menu is shown as an actual 
menu. WindList maintains alphabetical lists of directories 
and commands so that commands can be reissued easily. 


The new version now automatically detects DOS commands 
and runs them in their own customizable window. 

Springtime Software also sells MagWind and BitView. 
MagWindow acts as a magnifying lens for the rest of the 
screen, no matter what Windows or DOS applications in a 
window are displayed. BitView is a fast .bmp file viewer. 

WindList costs $39.95, MagWind costs $19.95, and Bit- 
View costs $15.95. For more information, contact Springtime 
Software, 81 Amherst Avenue, Waltham, MA 02154-3167; 
(800) 458-2829 or (617) 894-9455. 


CRISP Offers BRIEF Emulation on NT 

CRISP is a new text editor available on a variety of UNIX 
platforms and on Windows NT. CRISP provides a true emula¬ 
tion of BRIEF and can compile and run existing BRIEF macros. 
Emulations for other DOS editors such as Vedit, MultiEdit, 
WordStar, and Kedit are also available on request 

CRISP comes both as a true X product having buttons, 
scrollbars, pinnable menus, full mouse support, etc., and as a 


character-based product that can provide a windowing en¬ 
vironment on dumb terminals. 

CRISP for Windows NT costs $189. For more information, 
contact VITAL, 10755 MeadowGIen Lane, #238, Houston, 
TX 77042, (713) 781-7406. 
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Windows Charting Tools 

Quinn-Curtis's Windows Charting Tools is a collection of 
general-purpose graphics and user interface routines that 
solve the most common charting problems encountered in 
scientific, engineering, and business charting applications. 

The product has been specifically written for Windows 3.1. 

The library of C functions can be used to create a wide 
variety of chart types, including line plots, area plots, horizon¬ 
tal and vertical bar graphs (with 3-D bar options), floating 
bars, scatter plots, group plots, error bars, high-low-dose 
plots, and pie charts (with 3-D pie chart options). Multiple 
chart types, data objects, x- and y-axes can be combined in 


the same graph. Axes can be set for linear or logarithmic 
scaling. Built-in dialog boxes can be used to edit chart charac¬ 
teristics such as graph position, plot attributes, axes 
parameters, fonts, and data. Once the charts are created, 
they can be printed on any Windows-compatible printer at 
the resolution of the output device. 

Windows Charting Tools costs $400, or $800 with com¬ 
plete source code. For more information, contact Quinn-Cur- 
tis, 35 Highland Circle, Needham, MA 02194, (617) 

449-6155; FAX (617) 449-6109. 


NCR offers NICE for Windows Development 


NCR has released NICE, which stands for Natural Interface 
for Computing Environments, NCR’s first Windows software 
development product A software development kit designed 
to work with Microsoft's Visual Basic and c languages, NICE 
runs under Windows 3.1. Applications created with NICE can 
be used with touch screen, mouse, and pen input 

NICE was created to simplify the application developer's 
design efforts. The product is packaged with the NICE Human 


Interface Design Guide, which walks a developer through the 
steps required to design an optimal interface for the way 
people interact with a computer. NICE is equipped with a 
library of custom controls, such as an edit box, keypads, mul¬ 
tifunction buttons, and graphic buttons. 

NICE costs $199. For more information, contact NCR Cor¬ 
poration, Dayton, OH 45479, (800) 243-NICE 


ImageSoft Updates Windows Tools 

ImageSoft has released Object/Designer v2.0, a new ver¬ 
sion of its extensible C++, C, and Pascal application generator 
for Windows. The new version provides seamless support for 
custom controls, including the ability to generate custom 
source code for custom controls. The product also allows 
you to place user code within protea brackets in order to 
preserve it during code regeneration. You can now import 
and export menus, tool bars, windows, and dialogs, to create 
standard interface objects that can be reused in multiple 
projects. The menu design module has been completely 
redesigned to make it easier to use and provide support for 
menu item accelerators. The new version provides full sup¬ 
port for Windows 3.1 features such as the common dialogs 
and sound files, and includes an enhanced source driver 
scripting language for easier control of source code genera¬ 


tion. The produa now supports CommonView and zApp ap¬ 
plication frameworks. 

The company has also released the Microsoft C/C++ ver¬ 
sion of ImagingObjects v2.0, a C++ imaging toolkit designed 
to help developers create imaging applications. Among the 
more than 100 processing funaions of ImagingObjects are 
spatial manipulation, zoom, radiometric manipulation, con¬ 
volution, statistics, printing, display support, scroll, resize, 
blend, cut, copy, paste, add, subtraa, halftone, sharpen, 
gamma correa, and more. ImagingObjects works with 1-, 2-, 
4-, and 8-bit per pixel images. 

For more information, contaa ImageSoft Inc., 2 Haven 
Avenue, Port Washington, NY 11050, (516) 767-2233; FAX 
(516)767-9067. 


ToolDriver Provides Project-Wide Renaming 


ToolDriver is a software management environment for 
DOS with cross-reference and naming convention changing 
capabilities. It supports software written with any combina¬ 
tion of Oracle, C, C++, Pascal, COBOL, FORTRAN, batch files, 
and other languages. It also works with text files containing 
projea documentation. 

You can use ToolDriver to cross-reference a project. First, 
you identify the parent direaory containing the various ap¬ 
plication files. Then, ToolDriver scans files in that direaory 
tree for references to each other. You can view, print, or 
store the results in an export File for processing by other 
software. Some or all words may also be cross-referenced. 


To change names for porting an application from one 
platform to another, you specify the old and new names as 
well as the direaory containing the application's Files. The 
files, with their names transformed, are written to a new 
direaory, ready for compilation. Renaming is also useful for 
bringing older code up to a projea's current naming stand¬ 
ards. 

ToolDriver costs $59.95 and a full demo is available from 
CompuServe (72330,1621). For more information, contaa Con- 
Val Software, Inc., 11607 E Butter Creek Rd., Moorpark, 

CA 93021,(805)529-6847. 


DataTable Adds Borland Pascal Support 

The DataTable is a Windows spreadsheet control that of¬ 
fers advanced data formatting. It can interface with any 
database through generalized message handling. It can also 
be used with any standard dialog editor to create data entry 
and display screens. 

The DataTable supports several different memory 
management schemes, depending upon requirements, in¬ 
cluding multi-64Kb segment memory management. The 


DataTable supports over 20 different data types, including 
SQL Server and Sybase server data types of money, date/time, 
and more. Programmers can control The DataTable through a 
function API and numerous notification codes. 

The DataTable costs $249.95, or $495 with source. For 
more information, contaa ProtoView Development Co., 

353 Georges Road, Dayton, NJ 08810, (908) 329-8588; FAX 
(908>329-8624. 
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Modular Windows SDK Ships 

Microsoft Corporation is now shipping the Microsoft 
Modular Windows Software Development Kit (SDK). Modular 
Windows is a leaner operating system, based on Windows 
3.1 and providing compatibility with a subset of the Win¬ 
dows 3.1 API. Modular Windows is initially designed for 
devices that use televisions for display and it executes in 
1Mb of ROM; applications typically require an additional 1Mb 
of RAM. 

A variety of third-party tool vendors, including Borland 
and Symantec, have announced plans to support the new 
operating system. Also, for an introductory period of six 


months, the Modular Windows SDK will include the neces¬ 
sary extensions to create applications with Visual Basic for 
Modular Windows. 

The recommended development platform includes a 386 
PC with Windows, 4Mb of RAM, VGA-to-NTSC display adapter, 
MPC-compatible sound board and CD-ROM drive, 8-button 
hand controller (such as the Gravis PC Gamepad hand control¬ 
ler), the Windows 3.1 SDK, the Modular Windows SDK, and a 
C/C++ compiler. The Modular Windows SDK costs $99; 
developers can order it from Microsoft at (800) 227-4679. 


Quadbase-SQL for Windows Supports ODBC 


Quadbase Systems, Inc. is now shipping Quadbase-SQL 
v2.0 for Windows, an ODBC-compliant SQL database engine 
implemented as a DLL Besides adding ODBC support, the 
new version contains performance enhancements; SQL2 syn¬ 
tax compliant multi-table outer joins; a new Alter Table com¬ 
mand that lets you add new columns at any position, as 
well as drop, rename, or modify an existing column-, a BLOB 
(Binary Large Object) data type for multimedia applications; 
read-only schemas for CD-ROM distribution; 31-character 
table and field names; dynamic Embedded SQL for C, Visual 
Basic, and other Windows languages; custom controls for 
browsing and data entry in Visual Basic; and utilities that per¬ 
form schema dumps and integrity checks. 


Quadbase-SQL is designed to manage large amounts of 
data efficiently. The system supports updatable scroll cursors 
for interactive data browsing. The product fully supports the 
ANSI SQL-86 level 2 standard plus extensions (e.g„ referential 
integrity and outer join). Other features include multi-user 
concurrency control with four isolation levels, crash 
recovery, and transaction processing. 

Quadbase-SQL v2.0 for Windows costs $595 for a single- 
user development kit or $995 for a multi-user development 
kit For more information, contact Quadbase Systems, Inc., 
790 Lucerne Drive, Suite 51, Sunnyvale, CA 94086, (408) 
738-6989; FAX (408) 738-6980; CIS 70253,2145. 


Vermont Views Plus Breaks 640Kb Barrier 

Vermont Views Plus is a cross-platform application 
development tool that now supports DOS extenders. The Ver¬ 
mont Views Library includes almost 600 building-block ob¬ 
jects - C functions and fields such as pull-down, pop-up, and 
branching menus, exploding and rolling windows, choice 
lists, online and context-sensitive help, and validated data- 
entry fields. Vermont Views Plus includes packages that 
were formerly supplemental add-ons. 

Vermont Views Designer is an interactive screen desig¬ 
ner that lets developers draw and modify complex user inter¬ 
faces. Designer also creates a working prototype of the user 
interface, generating C source code for the finished applica¬ 
tion. Vermont Views MemEx supports both the VCPI and 
DPMI standards, and works with DOS extenders from various 
vendors, including the royalty-free extenders bundled with 


compilers such as Borland C++ v3.1, Watcom C 9.0/386, and 
Intel 386/486 C. Vermont Views GraphEx translates all text¬ 
mode menus, forms, and other screen displays into DOS or 
extended-DOS graphics modes. GraphEx works with popular 
third-party graphics libraries, including those that come with 
Microsoft and Borland C compilers, letting developers add 
charts, graphics, photographs, etc., to enhance text displays. 
Vermont Views includes documented source code for all 
libraries, including MemEx and GraphEx. 

Vermont Views Plus costs $795 and can be used with 
any database with a C interface, including Oracle, Informix, 
db_Vista, C-Tree, and Btrieve. For more information, contact 
Vermont Creative Software, Inc., Pinnacle Meadows, Rich- 
ford, VT 05476, (802) 848-7731 or (800) 242-1114; FAX 
(802) 848-3502. 


Manugistics Updates APL* PLUS II 

Manugistics, Inc, has released version 5 of APL'PLUS II, its 
APL system. This version includes all the tools needed to 
build Windows and DOS APL applications in an interactive 
programming environment The package includes an APL 
graphical user interface toolkit with a collection of object- 
oriented utilities to make Windows programming easier; the 
ability to communicate with other Windows applications via 
DDE; the APL'PLUS II debugger, which allows users to trace 
code as it runs; technical line charts and bar charts packaged 


as user commands, providing graphs on the screen, printer, 
or plotter; and new primitive functions that increase the 
compatibility between APL'PLUS II and IBM's APL2. 

APL'PLUS II v5 runs on 80386 and 80486 PCs under both 
DOS and Windows and costs $1700. Users with version 4 can 
upgrade for $345 until February 28, or for $445 thereafter. 

For more information, contact Manugistics, Inc., 2115 East 
Jefferson Street, Rockville, MD 20852, (301) 984-5000; FAX 
(301) 984-5290. 
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Readers' Forum 


To: Ron Burk, Editor 
Windows/DOS Developer’s journal 
Re: "A Drag-and-Drop Shell" by Noah 
Davids, Vol. 3, No. 12, December 1992. 

This little shell is interesting and use¬ 
ful. There were only minor changes 
necessary to make it work in my 
Microsoft environment. The only impor¬ 
tant change is fixing the typo in the .RC 
file listing. 

The typo is in byte 42 (decimal). The 
last 12 digits of the third line currently 
read: 

00 02 00 00 00 00 
and should read: 

80 02 00 00 00 00 

That field defines the number of bytes 
in the bitmaps for the icon. 

That will make the file editable with 
ICON editors. Also, the Microsoft 
resource compiler cannot handle ICONS 
as raw data in the .RC file that way. The 
same bytes may be put in the file 
DDSHELL.ICO with some binary editor. 
The DDSHELL.RC file then looks like this: 

DR0P_AND_DRAG ICON "DDSHELL.ICO" 

Thank you for printing articles as 
useful as this one. 

Jesse Chisholm 
Senior Software Engineer 
Acer America Corporation 
jesse@gumby.altos.com 

Thanks for the corrections. Icons 
are kind of a problem for magazine 
listings. I wish Microsoft would update 
RC so that it can handle hex descrip¬ 
tions of icons. While they are at it, they 
could make it a protected mode pro¬ 
gram — I’ve had to switch entirely to 
Borland's Resource Workshop be¬ 
cause I'm tired of rc.exe running out of 


memory even though I have many 
megabytes available, —rib 


Dear Mr. Burk, 

l think your tone, in your reply to 
Mr. Twaro’s letter (January 1993), may 
have been a bit pessimistic. He was 
looking for an article, of significance, 
about OS/2 2.0. I develop applications 
for a medium size company $ 1B 
revenue, 2000+ employees) and have 
for 25 years. Not “killer” apps, but the 
bread and butter type that keep 
revenue coming in and customers 
happy. My environment, I suspect not 
unlike many others, is a very large 
mainframe application and database 
server (250Gb+), an Ethernet attached 
Teradata database server (40Gb+) and a 
company-wide Token-Ring LAN with 
400+ PCs (DOS, Windows, and OS/2). I 
develop for this spectrum using tools 
from Microsoft, Borland, Lotus, Word¬ 
Perfect, IBM, Computer Associates, and 
Teradata. My development and 
workstation “platform," since September 
1991, is OS/2 2.0 on a 486 PC. It robustly 
supports ALL the tools and interfaces I 
need and does so in a very stable, 
preemptive multi-tasking environment. 
As a matter of fact, this letter is being 
written with WordPerfect for Windows, 
under OS/2 2.0. I suspect there are 
other developers who are using OS/2 
2.0 as their development platform. 

You mentioned, in your editorial 
(November 1992), that the world of DOS 
TSRs, device drivers, memory managers, 
etc. has become so complex as to 
swamp the brain and I agree. Multiple 
articles have appeared, some in the 
same issue, concerning how to squeeze 
the last byte into a DOS environment. 
That has, for the most part, become a 
non-issue for me, personally, because I 
now have 600Kb+ conventional 
memory, 2Mb+ expanded memory, 
2Mb+ extended memory, and 2Mb+ 
DPMI memory (all protected) in EACH 


DOS window I choose to open. If a TSR 
decides to go awry, it only affects that 
window, which I can close and restart 
from the desktop. If I choose, I can also 
I PL copies of "real" DOS, of any version, 
from any vendor, in a protected win¬ 
dow. I re-IPL each Monday morning, 
ONLY because I shut my machine down 
on Friday night. I believe Windows NT 
will have this stability and much of the 
robustness. However, it wasn't here in 
1991 and it isn't here, in general 
availability, now. 

I subscribe to Windows/DOS 
Developer's Journal, Microso/t Systems 
Journal, OS/2 Developer's Journal, Byte, 
ComputerWorld, and InfoWorld, and will 
continue to do so, because I need the 
latest information from each. Since your 
intended target audience is developers, 
I think you will do many of us a service 
if you can broaden your article scope to 
include mention of usable development 
platforms other than conventional 
DOS/Windows. 

Sincerely, 

Tom Carr 
5403 Pearce way 
Crestwood, KY 40014 

I can agree with most everything in 
your letter except the last point. You 
might be interested to know that there 
are more than 20,000 separate 
magazines published in the United 
States alone. The trend in information, 
whether it be television, radio, or 
magazines, is toward more, rather than 
less specialization. R&D is committed 
to providing excellent technical infor¬ 
mation to specific market niches. Of 
course, deciding where the boundary 
of your market is can be a matter of 
some debate. I believe that, as a 
large, feature-rich operating system, 
OS/2 is a distinct market that deserves 
its own technical publication, not just 
an occasional nod from us. I read 
“IBM OS/2 Developer” and I believe 
there is a new publication called 
“OS/2 Monthly" that looks interesting. 
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Like you, I have to subscribe to more than one magazine 
to get all the information I need. As a reader, I prefer focus 
- if it says OS/2 on the cover, I would rather they stuck to 
OS/2 rather than dabbling in other areas. So, for the 
foreseeable future, I have to tell you that we plan to continue 
increasing the quality and quantity of our Windows and DOS 
coverage and leave OS/2 to other publications. Thanks for 
your thoughtful comments, —rib 


Dear Editor, 

I had a problem with a program I had written for Windows 
3.1. I could not get the program to release all of the Global 
memory it used. 

The program is a version of BREAKOUT. When the player 
clears all the bricks and moves to the next level of play, it 
changes the color of the window’s background. I used the 
method recommended in Chapter 6, page 235, of Petzold's 
book, Programming Windows Version 3. Unfortunately, if you 


delete the existing brush before you assign a new one to the 
window, the DeleteObjectO fails and the brush's Global 
memory never gets released. 

To correct this I used the following code: 

{ 

HBRUSH tBrush; 

// Save handle of brush to be replaced 
tBrush = GetClassWordfhwnd, GCW_HBRBACKGROUND); 

// Replace brush 

SetClassWord(hwnd, GCW_HBRBACKGROUND, 

CreateSolidBrush(RGB(x, y, z))); 

// Delete old brush 
DeleteObject(tBrush); 

) 



Developer's 

Marketplace" 


! 1 

Windows 

Developer Jobs 


Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 



Scientific Placement, Inc. 

SPI-8. Box 19949, Houston. TX 77224 (713) 496-6100 
SP1-8, Box 71, San Ramon. CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 926-6188 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com: 
^CompuServe: 71250,3001; Genie: D.SMALL6 ^ 
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These Incredible Tools 
Make Windows.. 


Easy To Use. 




Springtime Software 

81 Amherst Avenue 
Waltham, MA 02154 




□ Request 119 on Reader Service Card □ 



Fast Way To 
Windows 

Let our MS-Windows specialists: 

t 

- PORT your existing application 


- DEVELOP a device driver 


- PROVIDE training and support 


DOS, MS-Windows 3.x 
Windows NT 


1-800-944-5463 

+ 

♦o it 



BACK ISSUES 
AVAILABLE 


Missed an Issue? 
Call today to get 
your copy. 

Ask for a complete 
listing of available 
back issues — we’ll 
send you a listing 

FREE! 


CALL 913 - 841-1631 
fax 913 - 841-2624 


Opt-Tech Sort/Merge 


Extremely fast Sort / Merge / 
Select utility. Run as an MS- 
DOS command or CALL as a 
subroutine. 

Supports most languages and 
filetypes including Btrieve and 
dBase. Unlimited filesizes, mul¬ 
tiple keys and much more! 

MS-DOS, Windows $149. 


OS/2, UNIX $249. 


Opt-Tech Data Processing 

P. O. Box 678 
Zephyr Cove. NV 89448 

(702) 588-3737 
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eXtraHelp 

Windows Developer: You have just 
delivered your Windows Application and the user 
is now requesting context-sensitive help. With 
eXtraHelp you can provide help without adding a 
single line of code to vour program . eXtraHelp is 
a simple cost-effective method for providing easy 
to use professional looking help. 

End-User: You have just received your 

Windows Application. The help system explains 
how the program works but there is no help for the 
unique way your company uses it. eXtraHelp is 
the tool that allows you to create context-sensitive 
help specific to your requirements. 

Features: Hyper-Text, paragraph formatting, 
multiple fonts, tabbing, color text , pictures and 
works with any windows program . Microsoft Help 
compiler and RTF editor not needed. $79 per 
copy. Please call or write for site license, quantity 
discount or developer pricing. 

Timenetics Inc. 908-464-5978 

39A WestviewAve. New Providence, N.J. 07974 
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FAST TEXT SEARCH 
for C / Windows 


The fastest, easiest and most versatile way to 
add full text search capabilities to your C and 
Windows applications, FAST TEXT SEARCH 
for C is a function library enabling rapid 
searches of both structured and unstructured 
textual data with low overhead/memory 
requirements, low cost and high efficiency. 
Great with CodeBase, SoftC, AccSys, etc. 
No Risk 30 day Money Back Guarantee 

Order-(800) 334-8099 
“ $189.00 


Only 

Windows/DOS Developer’s Journal Special includes 
UltraSearch & Free 2 Day Shipping 

DOS (Microsoft, Borland) and OS/2 libraries 
& Windows DLL, royalty free integrator license, 
complete printed documentation, sample 
programs & free technical support. 
VISA/MasterCard/COD/Qualified PO s accepted. 

Index Applications Incorporated 

8546 Broadway, Suite 208 
San Antonio, TX 78217 USA 
512 / 822-4818; fax: 512 / 828-5074 


(El 
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RELIEF 

from TLINK and LINK 
Headaches 

OPTLINK for Windows provides 
Borland developers with higher capacity 
linking intra-segment far call to near 
call conversions and Windows 
exe-packing. You get faster, more 
efficient programs. Microsoft 
developers get linking several times 
faster than LINK, Windows 
exe-packing and innovative build-time 
debugging features. 

It eliminates the 2nd pass of RC and 
generates DOS, Windows, and OS/2 
programs from C, C++, Basic, and 
Fortran objects. Ask us about out 
OPTLIB Superfast Librarian too. 30-day 
MBG. 

SLR Systems, Inc. 

(412) 282-0864 
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Visual Basic, 
BASIC, and PDS 
programmers! 

#8Strai Purpose Toolboxes 

ifnnSSlrf Design 
j^Wffifiijnications 



trttmk Apportions 
jifflffand more! 



Crescent Software offers many tools for 
QuickBASIC, PDS, and Visuol Basic. All 
products include complete source code, 
free technical support, and royalties are 

never required! 108 UIFRAIURf & FfiH DEMO MCXACfS 

CALL TOLL FREE 




CRESCENT SOFTWARE, INC. 

11 BAILEY AVENUE 
RIDGEFIELD, CT 06877-4505 
203438 5300 FAX 203431 4626 


Does your company provide 
tools, products, or services 
for advanced Windows 
programmers? 

Then reach over 27,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about advertising 
opportunities in Windows/DOS 
Developer’s Journal. 

Advanced. Serious. 
Technical. 

Brian Osborn - Continental Europe. 

Ed ■ East Donna - Midwest Edwin • West 


1:03 


TUB “ is FASTEST! 


1 0:19 B 


0:09 


RCS 4.2 PVCS™ TUB'" 3.0 TUB™ 5.0 


Times are to update a 45K library on a PC/XT, PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer. 


TUB™ is BEST! 

“Do not be fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare’’ 
John Rex, Computer Language 
“TUB is a great system" J. Vallino, PC Tech J 

• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus™ MAKE & Slick™ MAKE. 

MS-DOS $139, OS/2 $195 + shipping visa/MC 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919)233-8128 
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C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL: C-DOC ($199) All 5 programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (4161-858-4466 

L5N-4M1 Demos/BBS [416)-858-1916 


see AD INDEX for our larger ad 


NETBIOS MADE EASY! 


FOR WINDOWS 3.X 





The 

supports multiple applications 


Sigma 

NetBIOS 

Engine 

and instances. 

□ Full post processing support 
& notification via messages 
(wait no-wait and polled). 


□ Complete NCB and attached 

Create High 

data buffer functions simplify 

Performance 

memory management 

Network 

□ Complete documentation and 

Applications 

on-line API help reference. 

FAST! 

□ Control panel utility allows 
dynamic DLL configuration. 

□ WINDOWS.TXT compatibilty 

60 Day Money 

for DOS support 

Back Guarantee! 

□ No royalties, full source and 


demo programs $155.00! 


SIGMA SOFTWARE RESEARCH 


702 Windridge Dr 
Atlanta, GA 30350 

TEL (404) 992-0536 

Also available at the Programmer's Connection! 
□ Request 146 on Reader Service Card □ 


Er TCP/IP 

programmers! 

GENISYS Comm Pack++ 

GCP++ is a Windows server for your 
client apps, providing TCP/UDP/TEL- 
NEjT/TFTP and PEER protocol services 
with a 4 function API I 

> Quickly develop custom TCP/IP applications. 

- share files and buffers with UNIX hosts 

- turn your PC into a sophisticated server 
>- C/C++/Visual Basic compatible. 

>- Most TCP/IP stacks supported. 

>• New Evaluation Kit available. No Royalties! 

We do custom Windows & 
voice/data networking applications! 

GENISYS Comm, Inc. 

314 South Jay Street, Rome, NY 13440 
(315)339-5502 GCP++@GENISYS.com 
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When the program gets a WM_DESTROY message, I use the 
following code: 

{ 

HBRUSH tBrush; 

// Save handle of brush to be replaced 
tBrush = GetClassWord(hwnd, GCW_HBRBACKGROUND); 

// Replace brush with a Stock Object so it doesn't 
// need to be deleted 
SetClassWord(hwnd, GCWJBRBACKGROUND, 

GetStockObj ect(BLACK_BRUSH)); 

// Delete old brush 
DeleteObject(tBrush); 

) 

Richard Blessing 
10402 Riviere Vue Drive 
Biloxi, MS 39532 


Isn’t it amazing how many thousands of minute hoops we 
must jump through to create a Windows program that is 
really bug-free (as opposed to one that simply seems to 
work)? Looks like Charles caught this one, for the 3.1 ver¬ 
sion of his book uses the following construct: 

DeleteObject(SetClassWord(hwnd, 

GCWJBRBACKGROUND, CreateSol idBrush (...))); 

Thanks for pointing this out so folks who haven't bought the 
3.1 edition can red line their 3.0 copy, —rib 



Developer's 

Marketplace 


2 tm 

The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 


ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 

Wheeling, IL 60090 

(708) 394-0622 _ 
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COM1: - COM4: WITH WINDOWS! 

1,2, OR 4 FORT RS-232 BOARDS 
RS-232 AND RS-422 VERSIONS 
XT AND AT INTERRUPT JUMPERS 
OTHER PRODUCTS INCLUDING LAPTOP 
ADD-ONS 

DELIVERY FROM STOCK 
MADE IN USA 

EXCELLENT TECHNICAL SUPPORT 


SEALEVEL SYSTEMS INC. 
FO 80X630 
UBERTY.SC29657 

603 - 843-4343 


,5EflLEVEL 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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Image Compression 
for Windows 

* Compress/Decompress images in 
10 seconds or less. 

* Full Source Code & DLL's Available 

* Convert & View Multiple Images 

* Royalty Free Developers Kit Available 
+ PRICES START AT $99.00! 

Regular and Extended Dos also available 
® PHONE: 1-800-966-4487 
305-962-9961 
FAX: 305-962-6546 

Information Technologies Research,Inc 
3520 W Hallandale Beach Blvd 
Pembroke Park, FL 33023 
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DesignClips" Icons 


Open your WiitfltttvjS 
products with 
DesignClips Ieohs for 
Developers 


Over 3000 high-quality, custom-designed icons 
ready to add character, color and sophistication to 
any Windows application for only $299.95. 



With DesignClips royalty-free Icons, in an 
extended palette of 120 colors and in b&w, 
you can easily: 

Personalize your Windows product with 
unique icons available only from LetterSpace 
Modify and customize DesignClips Icons 
Save time, labor and resources over creating 
your own icons. 

Set your product apart from the competition 



DesignClips Icons— Designed to change 
your business into an industry. 


LetterSpace 


338 E 53 St #2C-3 New York NY 10022 Or call (212) 935-8130 

Amex, U.S. Checks and International Money Orders accepted. 

Include $5.00 Shipping. Specify 3.5 or 5.25 0D or HD diskettes. 


tvPAK for C++Turbo Vision 


Extend the power of Borland C++ 
Turbo Vision with Ted Faison's new 
class library. tvPAK adds over 25 
classes to TV, to support features 
commonly used in TV applications, 
such as data validation, property 
inspection, numeric fields, password 
fields, currency fields, line/box 
drawing, clocks, calendars and more. 

The tvPAK library has over 2000 lines of sample 
code, and comes with a detailed 200+ page 
Boriand-style manual .The full source code (over 
5000 lines worth) is also available. Turbo Vision 
programming will never be the samel tvPAK 
library code $49.95, source code $49.95. For 
VISA/MasterCard orders, call our 24 hour order 
desk at (714) 833-8410. 

Faison Computing 

P.O.B. 17722, Irvine, CA 9271S-7722 
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a 

SmartHcap professional memory man¬ 

<8 

agement library and debugging toolkit (for¬ 

X 

merly OptiMem from Applegate Software) 
is the only tool avail, w/ both fast, optimum 
mem mgmt and comprehensive error de¬ 

r 

tection. Combination of variable and fixed- 

(8 

E 

sizeallocators maximizes both performance 
and flexibility. Incl ANSI C"malloc"andC++ 
“new," + many other APIs. Fixes selector 

V) 

V 

consumption, overhead, granularity, frag¬ 
mentation, and DGROUP depletion. Mini¬ 
mizes disk thrashing by localizing data struc¬ 

u 

tures in their own heaps. Uses just 12K at 

0 

runtime. Detects double-freeing, mem over¬ 

1—1 

writes, leakage, invalid parameters, wild 

< 

pointers, etc. Programmatic error handling 

r-H 

and heap-walking. Works w/ EXEs, DLLs, & 


device drivers. Bullet-proof reliability, 

0 

“Who's who" user base. 166 page manual. 

b 

No royalties. Source available. $395 

+ 

CALL FOR FREE WHITE PAPER! 

u 

800-441-7822 

1—1 

FAX 206-525-8309 

CtJ 

£ 

MicroQuiU 

Software Publishing, Inc. 
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Simtel20 MSDOS CDROM* $24.95 

640 megabytes in 9000+ files. Programming tools, DOS 
utilities, tech docs, comm, bbs, publishing, ham-radio, 
education, and much more. Dated September 1992. 


CICA MS Windows CDROM* $24.95 

Hundreds of MS Windows programs. Utilities, games, 
source code, and programming tools. Dated July 1992. 


Source Code CDROM* $39.95 

XIIR5 and GNU CDROM $39.95 

Info-Mac CDROM* $39.95 

OS/2 Archive CDROM* $24.95 

AB20 Amiga CDROM* $24.95 

Garbo MSDOS/MAC CDROM* $24.95 
CDROM Caddies $4.95 


*Shareware programs require separate payment 
to authors if found useful. 


Walnut Creek CDROM 



1547 Palos Verdes Mall 
Suite 260 
Walnut Creek, CA 94596 

+ 1-800-786-9907 
+ 1-510-947-5996 
FAX +1-510-947-1644 
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Graphics & Timing Tools 


PC Timer Tools - Microsecond resolution timing, 
delays, interrupt profiling, asynchronous thread 
scheduler, and timer tick interrupt management in a 
PC/MSDOS environment. No external hardware 
needed! Supports TC, TC++, BC++, MSC, Intel 386 
Code Builder, Zortech, Turbo Pascal. $69.95. 

New! PC Timer Objects, OOP version for TC++, 
BC++, MSC++, ZTC++, Turbo Pascal Objects. $69.95. 

BGI Printer Driver Toolkit - bgi printer 

drivers for Borland's BGI graphics library. Epson/IBM 9 
pin, Epson/IBM 24 pin, LaserJet, DeskJet, PaintJet, 
Postscript, HPGL, PCX, others. Not a screen dump - 
load our drivers with BGI's initgraph and get full 
hardcopy device resolution. Supports TC, TC++, 
BC++, Turbo Pascal. $89.95. 


BGI For Windows - BGI compatible interface to 
Windows 3.x GDI. Port your Borland DOS BGI 
jphics routines effortlessly to Windows. Full stroke 
font, 256 color, hardcopy support Supports TCW, 
BC++, TPW. $89.95 


All toolkits include full source & object code or 
driver distribution license VISA & MasterCard 
accepted. Add $4.00 shipping USA, $7.00 elsewhere. 
Our 30 day "No Questions Asked" return policy 
guarantees satisfaction. 

Ryle Design 

PO Box 22, Mt. Pleasant, Michigan 48804 USA 
Voice/Fax: 517.773.0587 
BBS: 517.772.2393 CIS: 73047,1765 
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TURN A PC INTO A POWERFUL 
SERIAL COMMUNICATIONS 
PROTOCOL ANALYZER 


CEUM 
LAB 


f 


VERSION 1.01 
$395“ 

THE 

FEATURES 
& PERFORMANCE OF AN 
EXPENSIVE HARDWARE ANALYZER 
AT A FRACTION OF THE COST. . . 
PLUS YOU CAN CREATE CUSTOM 
CAPTURE & ANALYSIS PROGRAMS 
WITH OUR BUILT IN EDITOR & 

"C" COMPILER 


VERSION 2.0 

$495.oo 

WITH RT CARD 

$890.oo 

vrzr 


• Use standard COM1 /COM2 
NO special cables required 

• (isecond liming accuracy 

• Easy to use menus & 
user defined windows 

• Data To & From disk 

• Capture & Transmit 
in both directions 
SYNC or ASYNC 



REALTIME 
CONTROL, INC 

(904) 373-2626 
(800) 232-0485 
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ABSOLUTELY, 
POSITIVELY, 
NO MORE 

V.ls T i^O- 

E r R° r s/ 


$5/disk, 

one issue per disk 
or ALL of 1992 
or 1991 for $20! 

Call today! 

913 - 841-1631 

FAX 913-841-2624 


WindowsTDOS 

□ developer's journal 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 



SDLC, HDLC OR X.25 
SUPPORT ON THE PC 

Use the Sangoma SDLA card to 

provide exceptionally cost effective, full 

featured, stable and easy to use link 

support for your product or project. 

• Une speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Menu driven test program included 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation 

• High level interfaces for X.25 under 
DOS, UNIX, Windows, OS/2. 

SangOma Technologies Inc. 
Tel: (416) 474-1990; (800) 388-2475 
FAX: (416) 474-9223 


Speak-EZ 


C++ Class Libraries 
for Windows Multimedia 
Sound Application Development 


• Easily Add Sound Support To 
Windows Applications! 

• Class Libraries provide full support 
for Waveform, MIDI, & CD-ROM 
interfaces. 

• Complete encapsulation of MCI 
audio services. 

• $99 for Static Libs & DLLs, 

$250 w/source. No Runtime Royalties! 


Sound <No/iizons 

P.O. Box 6625, Holliston, MA 01746 
(508) 643-2882 


March 1993 


□ Request 132 on Reader Service Card □ 

Windows/DOS Developer's Journal — Page 87 








































Advertiser Index 


Advertiser ... Reader Service Number ... 


Advertiser ... Reader Service Number _ 

Page 

AccuSoft Corporation. 

. 120 ... 

.16 

Klondike Software Inc. 

* * 

...11 

ADONIS Micro-Software. 

. 116 ... 

.37 

pC/OS. 

...337 . 

...34 

Advanced Design Solutions . 

.110 ... 

.59 

MicroQuill . 

...310 . 

.. .87 

Austin Code Works . 

.332 ... 

.1 

NetManage, Inc. 

...131 .... 

...21 

Best Programs. 

* * 

.52 

Nu-Mega Technologies. 

...341 .... 

. .. C4 

Black Ice Software, Inc. 

. 139 . .. 

.44 

One Tree Software . 

...164 .... 

...10 

Burton Systems Software. 

. 137 ... 

.85 

Online Magazine Index. 

...117 .... 

...57 

Catenary Systems. 

.104 ... 

.28 

Opt-Tech Data Processing . 

...127 .... 

...84 

Classic Software . 

.143 ... 

.20 

Pocket Soft, Inc. 

...130 .... 

...C2 

Compass Point Software, Inc. 

.138 ... 

.32 

Premia Corporation. 

...136 .... 

...26 

CompuWare . 

* * 

.46 

Quadbase Systems, Inc. 

...175 .... 

.. .35 

Crescent Software, Inc. 

* * 

.85 

Realtime Control, Inc. 

...108 .... 

.. .87 

Dashboard Software . 

. 140 ... 

.5 

Ryle Design . 

...280 .... 

.. .87 

DataDraw. 

.311 ... 

.42 

Sangoma Technologies, Inc. 

* * 

...87 

David Curry Design. 

.118 ... 

.87 

Scientific Placement, Inc. 

...335 .... 

...84 

DBS GmbH. 

. 142 ... 

.15 

Sealevel Systems, Inc. 

...115 .... 

...86 

Desaware. 

. 113 ... 

.86 

Sequiter Software, Inc. 

...126 .... 

...C3 

Descriptor Systems . 

.123 ... 

.78 

Sigma Software Research . 

...146 .... 

.. .85 

Eclectic Software . 

. 124 ... 

.63 

Simple Software . 

...150 .... 

...31 

ETN Corporation . 

.148 ... 

.86 

SLR Systems. 

...154 .... 

...85 

Faison Computing. 

.112 ... 

.87 

Software Blacksmiths. 

...103 .... 

...85 

Far Point Technologies . 

.125 ... 

.3 

Software Blacksmiths. 

...135 .... 

.. .28 

FlashTek, Inc. 

. 107 ... 

.18 

Software Interphase. 

...319 .... 

...25 

GENISYS Communication, Inc. 

. 145 ... 

.85 

Sound Horizons. 

...132 .... 

.. .87 

GRiD Systems . 

.129 ... 

.33 

Springtime Software. 

...119 .... 

...84 

General Software, Inc. 

.102 ... 

.75 

Starlight Software . 

...170 .... 

...86 

Gimpel Software. 

* * 

.77 

The Software Factory. 

...133 .... 

...37 

HPI. 

.114 ... 

.42 

StratosWare Corporation . 

...153 .... 

...12 

IBM . 

* * 

.... 8, 9 

The Symmetry Group. 

...333 .... 

...51 

Index Applications . 

.121 ... 

.85 

Sybex, Inc. 

...134 .... 

. ..13 

Information Modes. 

.295 ... 

.17 

Timenetics, Inc. 

...141 .... 

...85 

Integrated Development Corporation 

. 147 ... 

.24 

V Communications . 

* * 

.. .47 

InternaX. 

.101 ... 

.71 

VPS Software . 

...144 .... 

...69 

IPT Corporation. 

.128 ... 

.84 

Walnut Creek CDROM. 

...105 .... 

...87 

Iterated Systems, Inc. 

.122 ... 

.24 

Willies’ Computer Software Co... 

...100 .... 

...39 

ITR Vision Software . 

.299 ... 

.86 

Windexperts, Inc. 

...Ill .... 

...65 

Kansmen Corporation . 

. 109 ... 

.41 

ZyLAB Corporation. 

...106 .... 

...17 

* 

* This advertiser prefers to be contacted directly. 



This index is provided as a service to our readers. The publisher assumes no liability for errors or omissions. 



Page 88 - Windows/DOS Developer’s Journal 


March 1993 















































































































































































SUBSCRIBE 

TODAY! 


1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-9950 USA 
(913) 841-1631 FAX: (913) 841-2624 


Windows/POS 

□ DEVELOPER'S JOURNAL 

REQUEST READER SERVICE NUMBERS: 


Please help us serve you by 
answering the following: 

1) I program: 

□ for a living 

□ as a manager 

□ as a hobby 

2) I program in: 

□ MS-DOS □ Windows 

3) I program most frequently in: 

□ C++ □ C 

□ Assembly 

□ Pascal 

□ Other 



Use with the March 1993 issue only. 


NAME 


COMPANY 


ADDRESS 


D Please start my subscription to 
Windows/DOS Developer’s Journal 
for one year. Bill me $29 (U.S.); $53 
(Canada/Mexico); or $64 (all other 
countries). 
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FAX 
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□ DEVELOPER'S JOURNAL 

□ YES! Send me 12 issues of Windows/DOS Developer’s Journal for only $29! 

□ 2 years (24 issues) for $54 □ 3 years (36 issues) for $77 

□ Bill Me Q Visa □ MasterCard 

Number_Exp._ 

Signature_ 
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Company 
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Country/Province/Mailcode 
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Please allow up to six weeks for delivery of first issue. Orders outside the US must be prepaid in US funds. CANADA/MEXICO 
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on products 
that affect 
your productivity. 
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Discover why FoxPro, Clipper, 
and dBASE were all written in C. 


^#here is a good reason why 
• your database language was 
developed in C. In fact, there 
are many good reasons. 


C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 


C speed - fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 



"Sieve of Erastothenes" 

Benchmark for Prime Number Generation 
Shows C to be incredibly faster! 


C size ■ small executables, 
no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 


C portability -ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, dBASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it’s your 
choice, we're compatible with you. 

Announcing 
CodeBase 5.0 

The power of a complete DBMS, the benefits ofC 

NEW - Multi-user sharing with 
FoxPro, Clipper and dBAaE... 

Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro. 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 

NEW - Queries & Relations 
1000 times faster... 

CodeBase 5.0 now lets you query related 


flic Align Database Croups Global Print Query Stylet Help 
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Summary 236 891,740.00 

To use CodeReporter, 



simply draw your report, then include it in any 
program you write. Call 403/437-2410 now for 
your FREE working model of CodeReporter. 


New - Design complex reports 
in just minutes... 

Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before April 30, 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee, so order today! 


a T-niii,., , 

i. The C/C++ Library for DataBase Management 

Call Now 
403 - 437-2410 



SEQUITER HI 

SOFTWARE INC. Ill 


FAX 

Europe 


403*436-2999 

3 3.2 0.2 4,2 0.1 4 


#209,9644-54 AVE., EDMONTON, AB, CANADA T6E-5V1 


©1992 Sequiler Software Inc. All rights reserved. CodeBase is a trademark ofSequiter Software Inc. All other trade names referenced herein are property of their respective companies. MAdvertising by MicroArts 
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Welcome to the age of 
automated memory/heap protection! 

NEW BOUNDS-CHECKER 2.0 is the crty complete solution to MS-DOS 
memory and heap corruption problems. 

BOUND-CHECKER 2.0 is a single, easy to use utility that automatically 
detects problems in your programs heap, stack or data segment and 
finds illegal memory accesses outside of your program or in your code. 
In one step, you can quickly and easily flush out some of the most 
insidious bugs that you regularly encounter as a DOS programmer. 


• New 2.0 Features • 

• Now works with 3rd party memory managers 

• Heap, stack and data segment checking 

• Smart Mode decides the legitimacy of an access automatically 

• No need to see assembly code - call stack lets you view source 
of calling routines. 

• New Auto Log mode (BC doesn't pop up) 

• Supports C7.0 & Borland 3.1 & VROOM 

Order NOW! Only $ 199 


Using BOUNDS-CHECKER 2.0 is simple, there are no changes to be made 
to your source in any way, and no linking of code or macros into your 
executable. When a bug is found, BOUNDS-CHECKER pops up showing 
you precisely where the problem is. 

One of its innovative NEW features is Smart Mode. Smart Mode uses a 
built-in knowledge base to automatically determine if an out-of-bounds 
access is legitimate. This eliminates any complex c ecisions on your part, 
resulting in more power and flexibility than you may have thought 
possible. 

Don't take unnecessary risks with your program or your customers. 
BOUNDS-CHECK before you ship with NEW version 2.0. 


For even more debugging power, BOUNDS-CHECKER 2.0 
integrates with our award-winning Soff-ICE debugger which fea¬ 
tures powerful 386/486 based breakpoints. Equipped with this 
formidable combination, your de-bugging arsenal is prepared for 
any surprise attack of the DOS Nasties. 

Soft-ICE...$386 

BOUNDS-CHECKER 2.0 & Soff-ICE Bundle Only...$499 

BOUNDS-CHECKER AND SOFT-ICE ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 


We're making C a Safe Language! 


Call (603) 889-2386 
fax (603) 889-1135 
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RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC| 

24 HOUR BBS 
603-595-0386 
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